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. PointerPressed
3. ポインタが移動しました
4. PointerRoutedAway
5. PointerRoutedTo
6. ポインターリリース
7. PointerExited

インコンタクト ポインターが別のターゲットにルーティングされ、もう一方のターゲットで解放される、有効な一連のイベントの例を次に示します。

1. ポインタが入力されました
2. PointerPressed
3. ポインタが移動しました
4. PointerRoutedAway
5. PointerRoutedReleased

別のターゲットからルーティングされたまったく新しいインコンタクト ポインターを受け取ることもできます。 この場合、ポインターが現在の InputPointerSource でまだ認識されていない場合、 PointerEntered イベントと PointerPressed イベントは PointerRoutedTo の前に存在することが保証されます。 この一連のイベントの例を次に示します。

1. ポインタが入力されました
2. PointerPressed
3. PointerRoutedTo
4. ポインタが移動しました
5. ポインターリリース
6. PointerExited

こちらもご覧ください

• CreateForInputPointerSource(InputPointerSource)