Partage via


PointerPointProperties Classe

Définition

Fournit des propriétés étendues pour un objet PointerPoint .

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

Si l’argument d’événement n’expose pas les détails du pointeur requis par votre application, vous pouvez accéder aux données de pointeur étendues à partir de l’argument d’événement via les méthodes getCurrentPoint et getIntermediatePoints ou les propriétés currentPoint et intermediatePoints . Nous vous recommandons d’utiliser les méthodes getCurrentPoint et getIntermediatePoints , car vous pouvez spécifier le contexte des données du pointeur.

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

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

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 diverses propriétés de pointeur étendues à 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 PointerPointProperties implémente IPointerPointProperties.

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).

Le cœur de l’architecture de périphérique d’entrée interactif Microsoft est basé sur la définition de classe de périphérique standard USB (Universal Serial Bus) pour les appareils d’interface humaine (HID), qui est définie par le Forum des implémenteurs, Inc.

La norme HID (Universal Serial Bus) (USB) Human Interface Device (HID) définit les protocoles de configuration et de communication pour les périphériques d’interface humaine (HID), tels que les claviers, les périphériques de souris, les joysticks et les appareils de réalité virtuelle, que les humains utilisent pour entrer des données directement dans un ordinateur. (Pour plus d’informations sur la norme USB HID, consultez le site web du Forum des implémenteurs USB .)

Bien que le cœur de l’architecture d’entrée Windows soit basé sur la norme HID (Universal Serial Bus) (USB) Human Interface Device, l’architecture n’est pas limitée aux périphériques USB (Universal Serial Bus). L’architecture d’entrée prend également en charge les périphériques de port série, les appareils de port i8042 et les périphériques d’entrée propriétaires.

Propriétés

ContactRect

Obtient le rectangle englobant de la zone de contact (généralement à partir d’une entrée tactile).

ContactRectRaw

Obtient le rectangle englobant de l’entrée brute (généralement à partir d’une entrée tactile).

IsBarrelButtonPressed

Obtient une valeur qui indique si le bouton du canon du stylet/du stylet est appuyé.

IsCanceled

Obtient une valeur qui indique si l’entrée a été annulée par le périphérique de pointeur.

IsEraser

Obtient une valeur qui indique si l’entrée provient d’une gomme de stylet.

IsHorizontalMouseWheel

Obtient une valeur qui indique si l’entrée provient d’une roulette d’inclinaison de la souris.

IsInRange

Obtient une valeur qui indique si l’appareil pointeur se trouve dans la plage de détection d’un capteur ou d’un numériseur (le pointeur continue d’exister).

IsInverted

Obtient une valeur qui indique si le stylet du numériseur est inversé.

IsLeftButtonPressed

Obtient une valeur qui indique si l’entrée du pointeur a été déclenchée par le mode d’action principal d’un périphérique d’entrée.

IsMiddleButtonPressed

Obtient une valeur qui indique si l’entrée du pointeur a été déclenchée par le mode d’action tertiaire d’un périphérique d’entrée.

IsPrimary

Obtient une valeur qui indique si l’entrée provient du pointeur principal lorsque plusieurs pointeurs sont inscrits.

IsRightButtonPressed

Obtient une valeur qui indique si l’entrée du pointeur a été déclenchée par le mode d’action secondaire (s’il est pris en charge) d’un périphérique d’entrée.

IsXButton1Pressed

Obtient une valeur qui indique si l’entrée du pointeur a été déclenchée par le premier bouton de souris étendu (XButton1).

IsXButton2Pressed

Obtient une valeur qui indique si l’entrée du pointeur a été déclenchée par le deuxième bouton de souris étendu (XButton2).

MouseWheelDelta

Obtient une valeur (valeur brute signalée par l’appareil) qui indique la modification de l’entrée du bouton wheel à partir du dernier événement de pointeur.

Orientation

Obtient l’angle de rotation dans le sens inverse des aiguilles d’une montre autour de l’axe principal du dispositif de pointeur (l’axe des z, perpendiculaire à la surface du numériseur). Une valeur de 0,0 degré indique que l’appareil est orienté vers le haut du numériseur.

PointerUpdateKind

Obtient le type de modification de l’état du pointeur.

Pressure

Obtient une valeur qui indique la force que le pointeur (généralement un stylet/stylet) exerce sur la surface du numériseur.

TouchConfidence

Obtient une valeur qui indique si l’appareil pointeur a rejeté le contact tactile.

Twist

Obtient la rotation dans le sens des aiguilles d’une montre en degrés d’un dispositif de stylet autour de son propre axe principal (par exemple, lorsque l’utilisateur fait tourner le stylet dans ses doigts).

XTilt

Obtient l’angle du plan entre le plan Y-Z et le plan qui contient l’axe Y et l’axe du périphérique d’entrée (généralement un stylet/stylet).

YTilt

Obtient l’angle du plan entre le plan X-Z et le plan qui contient l’axe X et l’axe du périphérique d’entrée (généralement un stylet/stylet).

ZDistance

Obtient la coordonnée z (ou distance) du pointeur à partir de la surface de l’écran, en pixels indépendants de l’appareil.

Méthodes

GetUsageValue(UInt32, UInt32)

Obtient la valeur d’utilisation de l’appareil d’interface humaine (HID) de l’entrée brute.

HasUsage(UInt32, UInt32)

Obtient une valeur qui indique si les données d’entrée de l’appareil de pointeur contiennent les informations d’utilisation hid (Human Interface Device) spécifiées.

S’applique à

Voir aussi