PointerPoint Classe

Definição

Namespace:

Microsoft.UI.Input

Fornece propriedades básicas para o ponteiro de entrada associado a um único mouse, caneta/caneta ou contato por toque.

public ref class PointerPoint sealed

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class PointerPoint final

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class PointerPoint

Public NotInheritable Class PointerPoint

Herança

Object Platform::Object IInspectable PointerPoint

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Exemplos

No exemplo a seguir, consultamos várias propriedades de ponteiro usando um objeto PointerPoint.

private string queryPointer(PointerPoint ptrPt)
{
    String details = "";

    switch (ptrPt.PointerDeviceType)
    {
        case PointerDeviceType.Mouse:
            details += "\nPointer type: mouse";
            break;
        case PointerDeviceType.Pen:
            details += "\nPointer type: pen";
            if (ptrPt.IsInContact)
            {
                details += "\nPressure: " + ptrPt.Properties.Pressure;
                details += "\nrotation: " + ptrPt.Properties.Orientation;
                details += "\nTilt X: " + ptrPt.Properties.XTilt;
                details += "\nTilt Y: " + ptrPt.Properties.YTilt;
                details += "\nBarrel button pressed: " + ptrPt.Properties.IsBarrelButtonPressed;
            }
            break;
        case PointerDeviceType.Touch:
            details += "\nPointer type: touch";
            details += "\nrotation: " + ptrPt.Properties.Orientation;
            details += "\nTilt X: " + ptrPt.Properties.XTilt;
            details += "\nTilt Y: " + ptrPt.Properties.YTilt;
            break;
        default:
            details += "\nPointer type: n/a";
            break;
    }

    details += "\nPointer Id: " + ptrPt.PointerId.ToString() +
        "\nPointer location: " + ptrPt.Position.X + ", " + ptrPt.Position.Y;

    return details;
}

Comentários

Consulte PointerPointProperties para obter propriedades estendidas acessíveis por meio de Propriedades.

O espaço de coordenadas do PointerPoint depende do contexto no qual ele é recuperado. Quando recuperado de PointerRoutedEventArgs.GetCurrentPoint, as coordenadas do ponteiro serão relativas ao UIElement fornecido em pixels independentes do dispositivo.

Propriedades

FrameId	Obtém a ID de um quadro de entrada.
IsInContact	Obtém um valor que indica se o dispositivo de entrada (toque, caneta/caneta) está pressionando para baixo (tocando) a superfície do digitalizador ou se um botão do mouse é pressionado para baixo.
PointerDeviceType	Obtém o tipo de dispositivo de entrada associado ao ponteiro de entrada.
PointerId	Obtém um identificador exclusivo para o ponteiro de entrada.
Position	Obtém o local do ponteiro de entrada.
Properties	Obtém informações estendidas sobre o ponteiro de entrada.
Timestamp	Obtém a hora em que a entrada ocorreu.

Métodos

GetTransformedPoint(IPointerPointTransform)

Recupera um novo objeto PointerPoint transformando o PointerPoint atual com uma transformação definida pelo aplicativo.

Confira também

• PointerPointProperties
• PointerRoutedEventArgs