UIElement.CapturePointer(Pointer) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
public:
virtual bool CapturePointer(Pointer ^ value) = CapturePointer;bool CapturePointer(Pointer const& value);public bool CapturePointer(Pointer value);function capturePointer(value)Public Function CapturePointer (value As Pointer) As Boolean参数
- value
- Pointer
指针对象引用。
返回
bool
true 如果对象具有指针捕获，则为 ;否则为 false。
示例
此示例演示基于处理 PointerPressed 的调用CapturePointer。 它还显示了跟踪和计数指针引用的模式。
int _pointerCount;
public Scenario2()
{
this.InitializeComponent();
bEnteredExited.PointerEntered += bEnteredExited_PointerEntered;
bEnteredExited.PointerExited += bEnteredExited_PointerExited;
bEnteredExited.PointerPressed += bEnteredExited_PointerPressed;
bEnteredExited.PointerReleased += bEnteredExited_PointerReleased;
bEnteredExited.PointerMoved += bEnteredExited_PointerMoved;
// To code for multiple Pointers (that is, fingers),
// we track how many entered/exited.
_pointerCount = 0;
}
private void bEnteredExited_PointerMoved(object sender,
PointerRoutedEventArgs e)
{
Scenario2UpdateVisuals(sender as Border, "Moved");
}
private void bEnteredExited_PointerReleased(object sender,
PointerRoutedEventArgs e)
{
((Border)sender).ReleasePointerCapture(e.Pointer);
txtCaptureStatus.Text = string.Empty;
}
//Can only get capture on PointerPressed (i.e. touch down, mouse click, pen press)
private void bEnteredExited_PointerPressed(object sender,
PointerRoutedEventArgs e)
{
if (tbPointerCapture.IsOn)
{
bool _hasCapture = ((Border)sender).CapturePointer(e.Pointer);
txtCaptureStatus.Text = "Got Capture: " + _hasCapture;
}
}
private void bEnteredExited_PointerExited(object sender,
PointerRoutedEventArgs e)
{
_pointerCount--;
Scenario2UpdateVisuals(sender as Border, "Exited");
}
private void bEnteredExited_PointerEntered(object sender,
PointerRoutedEventArgs e)
{
_pointerCount++;
Scenario2UpdateVisuals(sender as Border, "Entered");
}
private void Scenario2UpdateVisuals(Border border,
String eventDescription)
{
switch (eventDescription.ToLower())
{
case "exited":
if (_pointerCount <= 0)
{
border.Background = new SolidColorBrush(Colors.Red);
bEnteredExitedTextBlock.Text = eventDescription;
}
break;
case "moved":
RotateTransform rt =
(RotateTransform)bEnteredExitedTimer.RenderTransform;
rt.Angle += 2;
if (rt.Angle > 360) rt.Angle -= 360;
break;
default:
border.Background = new SolidColorBrush(Colors.Green);
bEnteredExitedTextBlock.Text = eventDescription;
break;
}
}
private void Scenario2Reset(object sender, RoutedEventArgs e)
{
Scenario2Reset();
}
private void Scenario2Reset()
{
bEnteredExited.Background = new SolidColorBrush(Colors.Green);
bEnteredExitedTextBlock.Text = string.Empty;
}
注解
仅当指针处于按下状态时，才能成功捕获指针 (应true) Pointer.IsInContact。 按下的物理构成将因指针设备类型 (按下鼠标按钮、触摸点向下、触笔接触) 而异。 如果尝试捕获未按下的指针，或者之前按下指针但现已释放的指针，CapturePointer 将 false返回 。 现有捕获不受返回 false的CapturePointer调用的影响。
通常捕获 PointerPressed 事件处理程序中的指针。 从处理程序的 PointerRoutedEventArgs 事件数据获取的 PointerPressedPointer 实例是从处理程序的代码中调用CapturePointer时应为value参数传递的值。
通常捕获指针，因为希望当前指针操作在应用中启动行为。 在这种情况下，通常不希望其他元素处理来自该指针操作的任何其他事件，直到行为完成或通过释放指针捕获取消为止。 如果捕获指针，则只有具有捕获的元素才能获取指针的输入事件，并且其他元素不会触发事件，即使指针进入其边界。 例如，假设有两个相邻元素的 UI。 通常，如果将指针从一个元素移到另一个元素，则首先从第一个元素获取 PointerMoved 事件，然后从第二个元素获取 PointerMoved 事件。 但是，如果第一个元素已捕获指针，则即使捕获的指针离开其边界，第一个元素仍会继续接收 PointerMoved 事件。 此外，当捕获的指针进入指针时，第二个元素不会为捕获的指针触发 PointerEntered 事件。
指针捕获状态和生成与指针捕获相关的事件并不完全由应用代码决定。 如果用户释放指针，则会生成 PointerReleased 事件，并且与该指针关联的指针捕获将丢失。 这还会在原始捕获元素上触发 PointerCaptureLost 。
在大多数情况下，当用户完成释放上一个指针捕获的输入操作时，指针捕获将自动释放， (抬起触摸点，松开鼠标左键，使触笔脱离) 范围。 可能释放捕获的另一个条件是还会触发 PointerCanceled 事件的任何操作。 你的应用通常可以依赖于与用户输入操作关联的捕获-发布行为，而无需使用 ReleasePointerCapture 或 ReleasePointerCaptures 专门取消指针捕获。 有关详细信息，请参阅鼠标交互。
如果已捕获指针，则 CapturePointer 方法将返回 false 。
UIElement 一次可以捕获多个指针点。
value使用 参数指示要捕获的 Pointer 实例。
表示笔势 (（例如 点击 或 DoubleTapped) ）的输入事件通常仅在释放指针后触发，因此不应尝试在手势事件的事件处理程序中捕获指针。 不允许手势事件的事件数据中的 指针 引用启动指针捕获。
提示
请勿尝试在与指针相关的输入事件处理程序的范围内使用 CapturePointer 。 除非 你有一个 指针，你确定与当时允许具有指针捕获的指针相关联，否则 CapturePointer 调用将没有任何影响。 没有使用新指针生成新 Pointer 和调用 CapturePointer 的实用方法。 应仅使用 Pointer 系统通过指针相关输入事件的事件数据提供的引用。