PointerPoint, classe

PointerPoint Class

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

Remarque  Dans la plupart des cas, nous vous recommandons d'obtenir les informations de pointeur via les gestionnaires d'événements de pointeur de votre infrastructure de langage Windows 8 sélectionnée (applications Windows Store utilisant JavaScript, applications Windows Store pour Windows utilisant C++, C# ou Visual Basic, ou applications Windows Store pour Windows utilisant DirectX avec C++). Le PointerPoint associé au gestionnaire d'événements fournit des informations dans le contexte de l'élément d'interface cible, alors que les méthodes PointerPoint (GetCurrentPoint et GetIntermediatePoints) fournissent des informations dans le contexte de la fenêtre ou de l'écran parent.

Syntaxe


var pointerPoint = Windows.UI.Input.PointerPoint;

Attributs

MarshalingBehaviorAttribute(None)
StaticAttribute(Windows.UI.Input.IPointerPointStatics, NTDDI_WIN8)
VersionAttribute(NTDDI_WIN8)

Membres

PointerPointClasse comporte les types de membres suivants :

Méthodes

The PointerPoint Classe comporte les méthodes suivantes. Avec C#, Visual Basic et C++, il hérite également des méthodes de Object Classe.

MéthodeDescription
GetCurrentPoint(UInt32) Retrieves position and state information for the specified pointer.
GetCurrentPoint(UInt32, IPointerPointTransform) Retrieves the transformed information for the specified pointer.
GetIntermediatePoints(UInt32) Retrieves position and state information for the specified pointer, from the last pointer event up to and including the current pointer event.
GetIntermediatePoints(UInt32, IPointerPointTransform) Retrieves the transformed position and state information for the specified pointer, from the last pointer event up to and including the current pointer event.

 

Propriétés

Le PointerPointClasse contient les propriétés suivantes.

PropriétéType d’accèsDescription

FrameId

en lecture seuleGets the ID of an input frame.

IsInContact

en lecture seuleGets a value that indicates whether the physical entity (touch, pen/stylus, or mouse button) is pressed down.

PointerDevice

en lecture seuleGets information about the device associated with the input pointer.

PointerId

en lecture seuleGets a unique identifier for the input pointer.

Position

en lecture seuleGets the location of the pointer input in client coordinates.

Properties

en lecture seuleGets extended information about the input pointer.

RawPosition

en lecture seuleGets the raw location of the pointer input in client coordinates.

Timestamp

en lecture seuleGets the time when the input occurred.

 

Remarques

La classe PointerPoint implémente IPointerPoint.

Consultez PointerPointProperties pour obtenir les propriétés étendues accessibles via Properties.

Remarque   : 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 Threads et marshaling (C++/CX) et Utilisation d'objets Windows Runtime dans un environnement multithread (.NET).

Exemples

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


// Get extended pointer data.
function queryPointer(e) {
    // We get the extended pointer info through the getCurrentPoint method
    // of the event argument. (We recommend using getCurrentPoint 
    // to ensure the coordinate space is in relation to the target.)
    // Note: getCurrentPoint and currentPoint are only available in the 
    // local compartment, they are not available in the web compartment.
    var ptTargetProperties = e.getCurrentPoint(e.currentTarget).properties;

    var details = "Pointer Id: " + e.pointerId;
    switch (e.pointerType) {
        case e.MSPOINTER_TYPE_MOUSE:
            details += "\nPointer type: mouse";
            details += "\nLeft button: " + ptTargetProperties.isLeftButtonPressed;
            details += "\nRight button: " + ptTargetProperties.isRightButtonPressed;
            details += "\nWheel button: " + ptTargetProperties.isMiddleButtonPressed;
            details += "\nX1 button: " + ptTargetProperties.isXButton1Pressed;
            details += "\nX2 button: " + ptTargetProperties.isXButton2Pressed;
            break;
        case e.MSPOINTER_TYPE_PEN:
            details += "\nPointer type: pen";
            if (ptProperties.isInContact) {
                details += "\nPressure: " + ptTargetProperties.pressure;
                details += "\nrotation: " + ptTargetProperties.rotation;
                details += "\nTilt X: " + ptTargetProperties.tiltX;
                details += "\nTilt Y: " + ptTargetProperties.tiltY;
                details += "\nBarrel button pressed: " + ptTargetProperties.isBarrelButtonPressed;
            }
            break;
        case e.MSPOINTER_TYPE_TOUCH:
            details += "\nPointer type: touch";
            details += "\nPressure: " + ptTargetProperties.pressure;
            details += "\nrotation: " + ptTargetProperties.rotation;
            details += "\nTilt X: " + ptTargetProperties.tiltX;
            details += "\nTilt Y: " + ptTargetProperties.tiltY;
            break;
        default:
            details += "\nPointer type: " + "n/a";
            break;
    }
    details += "\nPointer location (target): " + e.offsetX + ", " + e.offsetY;
    details += "\nPointer location (screen): " + e.screenX + ", " + e.screenY;

    return details;
}


Configuration requise

Client minimal pris en charge

Windows 8 [Applications du Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications du Windows Store uniquement]

Téléphone minimal pris en charge

Windows Phone 8

Espace de noms

Windows.UI.Input
Windows::UI::Input [C++]

Métadonnées

Windows.winmd

Voir aussi

Classes Windows.UI.Input

 

 

Afficher:
© 2016 Microsoft