Partager via

PointerPoint Classe

  • Référence

Définition

Espace de noms:
Windows.UI.Input
Modifier

Fournit des propriétés de base pour le pointeur d’entrée associé à une seule souris, un stylet ou un contact tactile.

public ref class PointerPoint sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
class PointerPoint final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
public sealed class PointerPoint
Public NotInheritable Class PointerPoint
Héritage
Object Platform::Object IInspectable PointerPoint
Attributs
ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Dans l’exemple suivant, nous interrogeons différentes propriétés de pointeur à l’aide d’un objet PointerPoint.

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

    switch (ptrPt.PointerDevice.PointerDeviceType)
    {
        case Windows.Devices.Input.PointerDeviceType.Mouse:
            details += "\nPointer type: mouse";
            break;
        case Windows.Devices.Input.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 Windows.Devices.Input.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;
    }

    GeneralTransform gt = Target.TransformToVisual(page);
    Point screenPoint;

    screenPoint = gt.TransformPoint(new Point(ptrPt.Position.X, ptrPt.Position.Y));
    details += "\nPointer Id: " + ptrPt.PointerId.ToString() +
        "\nPointer location (parent): " + ptrPt.Position.X + ", " + ptrPt.Position.Y +
        "\nPointer location (screen): " + screenPoint.X + ", " + screenPoint.Y;
    return details;
}

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

    switch (ptrPt.PointerDevice.PointerDeviceType)
    {
        case Windows.Devices.Input.PointerDeviceType.Mouse:
            details += "\nPointer type: mouse";
            break;
        case Windows.Devices.Input.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 Windows.Devices.Input.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;
    }

    GeneralTransform gt = Target.TransformToVisual(page);
    Point screenPoint;

    screenPoint = gt.TransformPoint(new Point(ptrPt.Position.X, ptrPt.Position.Y));
    details += "\nPointer Id: " + ptrPt.PointerId.ToString() +
        "\nPointer location (parent): " + ptrPt.Position.X + ", " + ptrPt.Position.Y +
        "\nPointer location (screen): " + screenPoint.X + ", " + screenPoint.Y;
    return details;
}

Remarques

La classe PointerPoint implémente IPointerPoint.

Consultez PointerPointProperties pour connaître les propriétés étendues accessibles via Propriétés.

Dans la plupart des cas, nous vous recommandons d’obtenir des informations de pointeur via l’argument d’événement des gestionnaires d’événements de pointeur dans l’infrastructure de langage choisie.

Si l’argument d’événement n’expose pas intrinsèquement les détails du pointeur requis par votre application, vous pouvez accéder aux données de pointeur étendues via les méthodes GetCurrentPoint et GetIntermediatePoints de PointerRoutedEventArgs. Utilisez ces méthodes pour spécifier le contexte des données du pointeur.

Les méthodes Pointeur statiques, GetCurrentPoint et GetIntermediatePoints, utilisent toujours le contexte de l’application.

Notes

Cette classe n’est pas agile, ce qui signifie que vous devez prendre en compte son modèle de thread et son comportement de marshaling. Pour plus d’informations, consultez Threading and Marshaling (C++/CX) et Utilisation d’objets Windows Runtime dans un environnement multithread (.NET).

Propriétés

FrameId

Obtient l’ID d’un frame d’entrée.
IsInContact

Obtient une valeur qui indique si le périphérique d’entrée (tactile, stylet/stylet) touche la surface du numériseur ou si un bouton de la souris est enfoncé.
PointerDevice

Obtient des informations sur l’appareil associé au pointeur d’entrée.
PointerId

Obtient un identificateur unique pour le pointeur d’entrée.
Position

Obtient l’emplacement de l’entrée du pointeur dans les coordonnées du client.
Properties

Obtient des informations étendues sur le pointeur d’entrée.
RawPosition

Obtient les coordonnées client du pointeur d’entrée comme indiqué par le périphérique d’entrée.
Timestamp

Obtient l’heure à laquelle l’entrée s’est produite.

Méthodes

GetCurrentPoint(UInt32)

Récupère les informations de position et d’état pour le pointeur spécifié.

Dans la plupart des cas, nous vous recommandons d’obtenir des informations de pointeur via l’argument d’événement des gestionnaires d’événements de pointeur dans l’infrastructure de langage de votre choix (application Windows utilisant JavaScript, application UWP utilisant C++, C# ou Visual Basic, ou application UWP utilisant DirectX avec C++).

Si l’argument d’événement n’expose pas intrinsèquement les détails du pointeur requis par votre application, vous pouvez accéder aux données de pointeur étendues via les méthodes GetCurrentPoint et GetIntermediatePoints de PointerRoutedEventArgs. Utilisez ces méthodes pour spécifier le contexte des données du pointeur.

Les méthodes Pointeur statiques , GetCurrentPoint et GetIntermediatePoints, utilisent toujours le contexte de l’application.
GetCurrentPoint(UInt32, IPointerPointTransform)

Récupère les informations transformées pour le pointeur spécifié.

Dans la plupart des cas, nous vous recommandons d’obtenir des informations de pointeur via l’argument d’événement des gestionnaires d’événements de pointeur dans l’infrastructure de langage de votre choix (application Windows utilisant JavaScript, application UWP utilisant C++, C# ou Visual Basic, ou application UWP utilisant DirectX avec C++).

Si l’argument d’événement n’expose pas intrinsèquement les détails du pointeur requis par votre application, vous pouvez accéder aux données de pointeur étendues via les méthodes GetCurrentPoint et GetIntermediatePoints de PointerRoutedEventArgs. Utilisez ces méthodes pour spécifier le contexte des données du pointeur.

Les méthodes Pointeur statiques, GetCurrentPoint et GetIntermediatePoints, utilisent toujours le contexte de l’application.
GetIntermediatePoints(UInt32)

Récupère les informations de position et d’état pour le pointeur spécifié, à partir du dernier événement de pointeur jusqu’à et y compris l’événement de pointeur actuel.

Dans la plupart des cas, nous vous recommandons d’obtenir des informations de pointeur via l’argument d’événement des gestionnaires d’événements de pointeur dans l’infrastructure de langage de votre choix (application Windows utilisant JavaScript, application UWP utilisant C++, C# ou Visual Basic, ou application UWP utilisant DirectX avec C++).

Si l’argument d’événement n’expose pas intrinsèquement les détails du pointeur requis par votre application, vous pouvez accéder aux données de pointeur étendues via les méthodes GetCurrentPoint et GetIntermediatePoints de PointerRoutedEventArgs. Utilisez ces méthodes pour spécifier le contexte des données du pointeur.

Les méthodes Pointeur statiques, GetCurrentPoint et GetIntermediatePoints, utilisent toujours le contexte de l’application.
GetIntermediatePoints(UInt32, IPointerPointTransform)

Récupère les informations de position et d’état transformées pour le pointeur spécifié, à partir du dernier événement de pointeur jusqu’à et y compris l’événement de pointeur actuel.

Dans la plupart des cas, nous vous recommandons d’obtenir des informations de pointeur via l’argument d’événement des gestionnaires d’événements de pointeur dans l’infrastructure de langage de votre choix (application Windows utilisant JavaScript, application UWP utilisant C++, C# ou Visual Basic, ou application UWP utilisant DirectX avec C++).

Si l’argument d’événement n’expose pas intrinsèquement les détails du pointeur requis par votre application, vous pouvez accéder aux données de pointeur étendues via les méthodes GetCurrentPoint et GetIntermediatePoints de PointerRoutedEventArgs. Utilisez ces méthodes pour spécifier le contexte des données du pointeur.

Les méthodes Pointeur statiques, GetCurrentPoint et GetIntermediatePoints, utilisent toujours le contexte de l’application.

S’applique à

Voir aussi