InputPointerSource Clase

Definición

Espacio de nombres:

Microsoft.UI.Input

Representa un objeto registrado para la entrada del puntero de informe y proporciona el control de eventos de entrada y cursor de puntero.

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

Herencia

Object Platform::Object IInspectable InputObject InputPointerSource

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo configurar un SwapChainPanel con CreateCoreIndependentInputSource y recibir una entrada táctil y un lápiz de baja latencia en un subproceso en segundo plano a través de 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();
}

En este ejemplo se muestra cómo configurar la imagen del cursor de mano del sistema para mostrar cuando el cursor mantiene el puntero sobre un 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);

Comentarios

El espacio de coordenadas de los eventos de puntero está en el mismo espacio de coordenadas que el objeto SwapChainPanel .

Orden de eventos

Caso normal

Los eventos de puntero de InputPointerSource siguen un orden garantizado en circunstancias normales:

1. PointerEntered
2. PointerPressed
3. PointerMoved
4. PointerReleased
5. PointerExited

Donde PointerMoved solo se generará si el puntero se mueve o si el botón cambia. Todos los eventos tienen el mismo identificador de puntero.

Captura de puntero perdida

PointerCaptureLost se genera cuando el sistema de entrada enruta un puntero en contacto a un destino de entrada diferente. Cuando se genera PointerCaptureLost, que solo se producirá después de que se haya recibido PointerPressed , no se generará ningún evento adicional para ese puntero. En concreto, pointerReleased y PointerExited no se generarán, por lo que debe controlar PointerCaptureLost como un estado final válido para un puntero determinado. Este es un ejemplo de una secuencia válida de eventos que incluye la pérdida de captura de puntero:

1. PointerEntered
2. PointerPressed
3. PointerMoved
4. PointerCaptureLost

Eventos enrutados

Los eventos enrutados de puntero se generan cuando el sistema de entrada enruta un puntero en contacto a un destino de entrada diferente. A diferencia de PointerCaptureLost, los eventos enrutados proporcionan la posibilidad de que el puntero en contacto se enrute de nuevo antes de que se libere el puntero.

A continuación se muestra una secuencia válida de eventos en los que el puntero en contacto se enruta a un destino diferente, se enruta de nuevo al inputPointerSource original y, a continuación, se libera:

1. PointerEntered
2. PointerPressed
3. PointerMoved
4. PointerRoutedAway
5. PointerRoutedTo
6. PointerReleased
7. PointerExited

Este es un ejemplo de una secuencia válida de eventos en los que un puntero en contacto se enruta a un destino diferente y, a continuación, se libera en el otro destino:

1. PointerEntered
2. PointerPressed
3. PointerMoved
4. PointerRoutedAway
5. PointerRoutedReleased

Nota

Cuando se genera PointerRoutedReleased, no se generará ningún evento adicional para ese puntero. En concreto, pointerReleased y PointerExited no se generarán, por lo que debe controlar PointerRoutedReleased como un estado final válido para un puntero determinado.

También es posible recibir un puntero nuevo en contacto que se enruta desde un destino diferente. En este caso, se garantiza que los eventos PointerEntered y PointerPressed preceden a PointerRoutedTo si el puntero no ha sido visto por el inputPointerSource actual todavía. A continuación se muestra un ejemplo de esta secuencia de eventos:

1. PointerEntered
2. PointerPressed
3. PointerRoutedTo
4. PointerMoved
5. PointerReleased
6. PointerExited

Propiedades

Cursor	Obtiene o establece el cursor que se muestra cuando un puntero de mouse o lápiz está sobre el destino de entrada, un Visual o WindowId (HWND), de este InputPointerSource.
DeviceKinds	Obtiene los tipos de dispositivo admitidos por este InputPointerSource.
DispatcherQueue	Obtiene dispatcherQueue para InputObject. (Heredado de InputObject)

Métodos

GetForIsland(ContentIsland)

Recupera un InputPointerSource objeto para contentIsland especificado.

Eventos

PointerCaptureLost	Se produce cuando un puntero en contacto con este InputPointerSource se mueve a otro destino de entrada.
PointerEntered	Se produce cuando un puntero se mueve a los límites de este InputPointerSource.
PointerExited	Se produce cuando un puntero sale de los límites de este InputPointerSource.
PointerMoved	Se produce cuando un puntero se mueve mientras se encuentra dentro de los límites de este InputPointerSource.
PointerPressed	Se produce cuando se presiona un botón del mouse, o un dedo o lápiz inician el contacto con la superficie del digitalizador, mientras que dentro de los límites de este InputPointerSource.
PointerReleased	Se produce cuando se suelta un dispositivo de puntero que inició previamente una acción Press (se suelta un botón del mouse o se levanta un contacto táctil o de lápiz de la superficie del digitalizador), mientras que dentro de los límites de este InputPointerSource.
PointerRoutedAway	Se produce cuando se redirige un puntero a otro InputPointerSource (posiblemente en un proceso independiente).
PointerRoutedReleased	Se produce cuando el puntero que se enruta a otro InputPointerSource se libera en ese otro destino de entrada.
PointerRoutedTo	Se produce cuando un puntero se enruta a este InputPointerSource desde un destino de entrada diferente.
PointerWheelChanged	Se produce cuando se gira la rueda del mouse (cambia el valor delta de la rueda).

Consulte también

• CreateForInputPointerSource(InputPointerSource)