InputPointerSource Classe

Riferimento

Definizione

Spazio dei nomi:: Microsoft.UI.Input

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Rappresenta un oggetto registrato per segnalare l'input del puntatore e fornire il cursore del puntatore e la gestione degli eventi di input.

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

Ereditarietà: Object Platform::Object IInspectable InputObject InputPointerSource

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Esempio

L'esempio seguente illustra come configurare un SwapChainPanel con CreateCoreIndependentInputSource e ricevere input tocco e penna a bassa latenza su un thread in background tramite un 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();
}

Questo esempio mostra come configurare l'immagine del cursore della mano di sistema da visualizzare quando il cursore passa il puntatore su un oggetto 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);

Commenti

Lo spazio delle coordinate per gli eventi del puntatore si trova nello stesso spazio di coordinate dell'oggetto SwapChainPanel .

Ordine eventi

Normale maiuscole/minuscole

Gli eventi puntatore di InputPointerSource seguono un ordine garantito in circostanze normali:

Puntatore immesso
PuntatorePresso
Puntatore spostato
PointerReleased
PuntatoreExited

Dove Puntatore spostato verrà generato solo se il puntatore si sposta o lo stato del pulsante sulla modifica del mouse. Tutti gli eventi hanno lo stesso ID puntatore.

Acquisizione puntatore persa

PointerCaptureLost viene generato quando un puntatore in contatto viene instradato a una destinazione di input diversa dal sistema di input. Quando viene generato PointerCaptureLost, che verrà generato solo dopo la ricezione di PointerPressed, non verranno generati eventi aggiuntivi per tale puntatore. In particolare, non verrà generato PointerReleased e PointerExited, pertanto è consigliabile gestire PointerCaptureLost come stato finale valido per un puntatore specifico. Di seguito è riportato un esempio di una sequenza valida di eventi che include la perdita dell'acquisizione del puntatore:

Puntatore immesso
PuntatorePresso
Puntatore spostato
PointerCaptureLost

Eventi indirizzati

Gli eventi indirizzati del puntatore vengono generati quando un puntatore in contatto viene instradato a una destinazione di input diversa dal sistema di input. A differenza di PointerCaptureLost, gli eventi indirizzati offrono la possibilità che il puntatore in contatto venga instradato di nuovo prima del rilascio del puntatore.

Di seguito viene illustrata una sequenza valida di eventi in cui il puntatore in contatto viene indirizzato a una destinazione diversa, indirizzata nuovamente all'oggetto InputPointerSource originale e quindi rilasciata:

Puntatore immesso
PuntatorePresso
Puntatore spostato
PointerRoutedAway
PointerRoutedTo
PointerReleased
PuntatoreExited

Di seguito è riportato un esempio di una sequenza valida di eventi in cui un puntatore a contatto viene instradato a una destinazione diversa e quindi rilasciato sull'altra destinazione:

Puntatore immesso
PuntatorePresso
Puntatore spostato
PointerRoutedAway
PointerRoutedReleased

Nota

Quando viene generato PointerRoutedReleased, non verranno generati altri eventi per tale puntatore. In particolare, non verrà generato PointerReleased e pointerExited, pertanto è consigliabile gestire PointerRoutedReleased come stato finale valido per un puntatore specifico.

È anche possibile ricevere un nuovo puntatore a contatto che è stato instradato da una destinazione diversa. In questo caso, gli eventi PointerEntered e PointerPressed hanno la certezza di precedere un PointerRoutedTo se il puntatore non è stato ancora visualizzato dall'oggetto InputPointerSource corrente. Di seguito è riportato un esempio di questa sequenza di eventi:

Puntatore immesso
PuntatorePresso
PointerRoutedTo
Puntatore spostato
PointerReleased
PuntatoreExited

Proprietà

Cursor	Ottiene o imposta il cursore visualizzato quando un puntatore del mouse o della penna si trova sulla destinazione di input, un Visual o WindowId (HWND), di questo InputPointerSource.
DeviceKinds	Ottiene i tipi di dispositivo supportati da questa InputPointerSource.
DispatcherQueue	Ottiene il DispatcherQueue per InputObject. (Ereditato da InputObject)

Metodi

GetForIsland(ContentIsland)

Recupera un oggetto InputPointerSource per il ContentIsland specificato.

Eventi

PointerCaptureLost	Si verifica quando un puntatore in contatto con questo InputPointerSource passa a un'altra destinazione di input.
PointerEntered	Si verifica quando un puntatore si sposta nei limiti di questo InputPointerSource.
PointerExited	Si verifica quando un puntatore esce dai limiti di questa InputPointerSource.
PointerMoved	Si verifica quando un puntatore si sposta all'interno dei limiti di questa InputPointerSource.
PointerPressed	Si verifica quando viene premuto un pulsante del mouse o un dito o una penna avviano il contatto con la superficie del digitalizzatore, mentre all'interno dei limiti di questa InputPointerSource.
PointerReleased	Si verifica quando viene rilasciato un dispositivo puntatore che in precedenza ha avviato un'azione Di pressione (viene rilasciato un pulsante del mouse o un contatto tocco o penna dalla superficie del digitalizzatore), mentre all'interno dei limiti di questa InputPointerSource.
PointerRoutedAway	Si verifica quando un puntatore viene reindirizzato a un altro InputPointerSource (possibilmente in un processo separato).
PointerRoutedReleased	Si verifica quando il puntatore che è stato indirizzato a un InputPointerSource diverso viene rilasciato in tale altra destinazione di input.
PointerRoutedTo	Si verifica quando un puntatore viene indirizzato a questo InputPointerSource da una destinazione di input diversa.
PointerWheelChanged	Si verifica quando la rotellina del mouse viene ruotata (il valore delta della rotellina cambia).

Si applica a

Vedi anche

CreateForInputPointerSource(InputPointerSource)

Condividi tramite