PointerDevice, classe

PointerDevice Class

Prend en charge la capacité à identifier les périphériques de pointeur connectés et à déterminer leurs fonctionnalités.

Syntaxe


var pointerDevice = Windows.Devices.Input.PointerDevice;

Attributs

[MarshalingBehavior(None)]
[Version(0x06020000)]

Membres

PointerDeviceClasse possède ces types de membres :

Méthodes

The PointerDevice Classe a les méthodes suivantes. Avec C#, Visual Basic et C++, elle hérite également des méthodes de Object Classe.

MéthodeDescription
GetPointerDevice Gets information about the pointer device associated with the specified input pointer ID.
GetPointerDevices Gets information about the pointer devices attached to the system.

 

Propriétés

Le PointerDeviceClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

IsIntegrated

En lecture seuleGets a value indicating whether the pointer device is an integrated device. For example, a video display with an integrated touch digitizer compared to an external pen/stylus digitizer.

MaxContacts

En lecture seuleGets a value indicating the maximum number of contacts supported by the input device.

PhysicalDeviceRect

En lecture seuleGets the coordinates of the bounding rectangle supported by the input device.

PointerDeviceType

En lecture seuleGets the pointer device type.

ScreenRect

En lecture seuleGets the screen coordinates that are mapped to the bounding rectangle supported by the input device.

SupportedUsages

En lecture seuleGets a collection containing the supported pointer device usages.

 

Remarques

Les valeurs retournées par les propriétés présentées ici sont basées sur le nombre total de dispositifs de pointage connectés : les propriétés booléennes retournent true si un seul dispositif prend en charge une fonctionnalité spécifique et les propriétés numériques retournent la valeur maximale exposée par tous les dispositifs.

L'Exemple de fonctionnalités des périphériques explique comment détecter la présence des périphériques d'entrée et récupérer les fonctionnalités et les attributs de chaque périphérique.

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

Windows Phone 8

Cette API n'est pas implémentée et lève une exception si elle est appelée. Consultez API de runtime Windows Phone.

Exemples

Le code suivant montre comment utiliser PointerDevice.


function getPointerDevicesAndAttributes() {
    var pointerDevices = Windows.Devices.Input.PointerDevice.GetPointerDevices();
    var htmlWrite = "";
    for (i = 0; i < pointerDevices.Size; i++)  {
         htmlWrite += "<tr><td>(" + i + ") Pointer Device Type</td><td>";
         htmlWrite += getPointerDeviceType(pointerDevices[i].PointerDeviceType) + "</td></tr>";
         htmlWrite += "<tr><td>(" + i + ") Is External</td><td>" + pointerDevices[i].IsExternal + "</td></tr>";
         htmlWrite += "<tr><td>(" + i + ") Max Contacts</td><td>" + pointerDevices[i].MaxContacts + "</td></tr>";
         htmlWrite += "<tr><td>(" + i + ") Physical Device Rect</td><td>" +
             pointerDevices[i].PhysicalDeviceRect.X + "," +
             pointerDevices[i].PhysicalDeviceRect.Y + "," +
             pointerDevices[i].PhysicalDeviceRect.Width + "," +
             pointerDevices[i].PhysicalDeviceRect.Height + "</td></tr>";
         htmlWrite += "<tr><td>(" + i + ") Screen Rect</td><td>" +
             pointerDevices[i].ScreenRect.X + "," +
             pointerDevices[i].ScreenRect.Y + "," +
             pointerDevices[i].ScreenRect.Width + "," +
             pointerDevices[i].ScreenRect.Height + "</td></tr>";
    }
    id("pointerDevices").innerHTML = htmlWrite;
}

Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Téléphone minimal pris en charge

Windows Phone 8 [non implémenté, consultez la section Notes]

Espace de noms

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

Métadonnées

Windows.winmd

Voir aussi

Windows.Devices.Input
Démarrages rapides
Démarrage rapide : identification des périphériques d'entrée

 

 

Afficher:
© 2017 Microsoft