InputPointerSource 類別

定義

public ref class InputPointerSource sealed : InputObject

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class InputPointerSource final : InputObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class InputPointerSource : InputObject

Public NotInheritable Class InputPointerSource
Inherits InputObject

繼承

Object Platform::Object IInspectable InputObject InputPointerSource

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

範例

以下範例展示了如何用 CreateCoreIndependentInputSource 配置 SwapChainPanel，並透過 DispatcherQueueController 在背景執行緒中接收低延遲的筆觸輸入。

void SetupBackgroundPenInput(SwapChainPanel swapChainPanel)
{
    m_dispatcherQueueController = DispatcherQueueController::CreateOnDedicatedThread();

    m_dispatcherQueueController.DispatcherQueue().TryEnqueue([this] {

        InputPointerSourceDeviceKinds deviceKind = (InputPointerSourceDeviceKinds)(
            Microsoft::UI::Input::InputPointerSourceDeviceKinds::Touch |
            Microsoft::UI::Input::InputPointerSourceDeviceKinds::Pen);
        m_coreInput = swapChainPanel().CreateCoreIndependentInputSource(deviceKind);

        m_coreInput.PointerMoved({ this, &DirectXPage::SwapChainPanel_OnPointerMoved });
        });
}


void DirectXPage::SwapChainPanel_OnPointerPressed(InputPointerSource const& sender, Microsoft::UI::Input::PointerEventArgs const& e)
{
    // When the pointer is pressed begin tracking the pointer movement.
    m_main->StartTracking();
}

以下範例展示了如何設定系統手游標影像，使其在游標懸停於 SwapChainPanel 上時顯示：

InputPointerSourceDeviceKinds deviceKind = (InputPointerSourceDeviceKinds)(
    Microsoft::UI::Input::InputPointerSourceDeviceKinds::Touch |
    Microsoft::UI::Input::InputPointerSourceDeviceKinds::Mouse |
    Microsoft::UI::Input::InputPointerSourceDeviceKinds::Pen);
m_coreInput = swapChainPanel().CreateCoreIndependentInputSource(deviceKind);

m_coreInput.InputCursor = InputSystemCursor.Create(InputSystemCursorShape.Hand);

備註

指標事件的座標空間與 SwapChainPanel 物件位於同一座標空間中。

活動順序

路由事件

當輸入系統將接觸中的指標路由到不同的輸入目標時，指標路由事件就會被觸發。 與 PointerCaptureLost 不同，路由事件提供了在釋放指標前，接觸中的指標被路由回去的可能性。

以下顯示一個有效的事件序列，當接觸中的指標被路由到另一個目標，再路由回原始的 InputPointerSource，然後釋放時：

1. 指針進入
2. 指針按下
3. 指標已移動
4. 指向路由
5. PointerRoutedTo
6. 指標已釋放
7. PointerExited

以下是一個有效的事件序列範例，當接觸中的指標被路由到另一個目標，然後釋放到另一個目標上：

1. 指針進入
2. 指針按下
3. 指標已移動
4. 指向路由
5. 指示已路由

你也可以收到來自其他目標的新聯絡指標。 在這種情況下，如果指標尚未被當前輸入來源看到， PointerEntered 和 PointerPressed 事件必定會先於 PointerRoutedTo 之前。 以下是這一事件序列的例子：

1. 指針進入
2. 指針按下
3. PointerRoutedTo
4. 指標已移動
5. 指標已釋放
6. PointerExited

另請參閱

• CreateForInputPointerSource(InputPointerSource)