Constantes PacketPropertyGuids
Définit des valeurs qui spécifient les propriétés du paquet. L’API PCAPI tablette utilise des identificateurs globaux uniques (GUID) pour identifier les propriétés de paquet, qui, dans COM, sont des chaînes constantes.
En C++, vous pouvez accéder à ces constantes dans le fichier d’en-tête Msinkaut.h, qui se trouve dans le <répertoire systemdrive>:\Program Files\Microsoft SDKs\Windows\v6.0\Include si vous avez installé le Kit de développement logiciel (SDK) à l’emplacement par défaut. En C++, ces constantes sont WCHAR, et non BSTR. Convertissez-les en BSTR avant utilisation. Pour plus d’informations sur le type de données BSTR, consultez Utilisation de la bibliothèque COM.
Le tableau suivant répertorie les champs GUID (Global Unique Identifier) de propriété de paquets disponibles. Utilisez ces GUID pour spécifier les propriétés que contient le paquet lorsque vous créez le contexte de la tablette. Pour déterminer la plage et la résolution d’une propriété, appelez la méthode GetPropertyMetrics . Les constantes du tableau ci-dessous commençant par « STR_ » sont des représentations sous forme de chaîne des constantes binaires correspondantes affichées dans la même cellule de table.
| Constant | Description |
|---|---|
|
Coordonnée x dans l’espace de coordonnées de la tablette. Chaque paquet contient cette propriété par défaut. L’origine (0,0) du comprimé est le coin supérieur gauche. |
|
Coordonnée y dans l’espace de coordonnées de la tablette. Chaque paquet contient cette propriété par défaut. L’origine (0,0) du comprimé est le coin supérieur gauche. |
|
Coordonnée y dans l’espace de coordonnées de la tablette. Chaque paquet contient cette propriété par défaut. L’origine (0,0) du comprimé est le coin supérieur gauche. |
|
Coordonnée z ou distance de la pointe du stylet à partir de la surface de la tablette. Le type d’énumération TabletPropertyMetricUnit détermine l’unité de mesure de cette propriété. |
|
Contient une ou plusieurs des valeurs d’indicateur suivantes :
|
|
Heure à laquelle le paquet a été généré. |
|
Heure à laquelle le paquet a été généré. |
|
Propriété de paquet permettant d’identifier le paquet. Il s’agit de la même valeur que celle que vous utilisez pour récupérer le paquet à partir de la file d’attente de paquets. |
|
Pression de la pointe du stylet perpendiculaire à la surface du comprimé. Plus la pression sur la pointe du stylet est élevée, plus l’encre est dessinée. |
|
Pression de la pointe du stylet le long du plan de la surface du comprimé. |
|
Pression sur un bouton sensible à la pression. |
|
Angle entre le plan y, z et le plan du stylet et de l’axe y. S’applique à un curseur de stylet. La valeur est 0 lorsque le stylet est perpendiculaire à la surface de dessin et est positif lorsque le stylet se trouve à droite de perpendiculaire. |
|
Angle entre le plan x,z et le plan du stylet et de l’axe X. S’applique à un curseur de stylet. La valeur est 0 lorsque le stylet est perpendiculaire à la surface de dessin et est positif lorsque le stylet se trouve vers le haut ou loin de l’utilisateur. |
|
Rotation dans le sens des aiguilles d’une montre du curseur sur l’axe des z dans une plage circulaire complète. |
|
Angle entre l’axe du stylet et la surface de la tablette. La valeur est 0 lorsque le stylet est parallèle à la surface et 90 lorsque le stylet est perpendiculaire à la surface. Les valeurs sont négatives lorsque le stylet est inversé. |
|
Rotation dans le sens des aiguilles d’une montre du curseur sur son propre axe. |
|
STR_GUID_PITCHROTATION ou GUID_PACKETPROPERTY_GUID_PITCH_ROTATION |
Propriété de paquet qui indique si la pointe se trouve au-dessus ou en dessous d’une ligne horizontale perpendiculaire à la surface d’écriture. Note: Cela nécessite un numériseur 3D. La valeur est positive si la pointe se trouve au-dessus de la ligne et négative si elle est en dessous de la ligne. Par exemple, si vous tenez le stylet devant vous et écrivez sur un mur imaginaire, le pitch est positif si la pointe est au-dessus d’une ligne qui s’étend de vous au mur. |
|
STR_GUID_ROLLROTATION ou GUID_PACKETPROPERTY_GUID_ROLL_ROTATION |
Rotation dans le sens des aiguilles d’une montre du stylet autour de son propre axe. Note: Cela nécessite un numériseur 3D. |
|
STR_GUID_YAWROTATION ou GUID_PACKETPROPERTY_GUID_YAW_ROTATION |
Angle du stylet à gauche ou à droite autour du centre de son axe horizontal lorsque le stylet est horizontal. Note: Cela nécessite un numériseur 3D. Si vous tenez le stylet devant vous et écrivez sur un mur imaginaire, zéro lacet indique que le stylet est perpendiculaire au mur. La valeur est négative si la pointe est à gauche de la perpendiculaire et positive si la pointe est à droite de la perpendiculaire. |
|
STR_GUID_YAWROTATION ou GUID_PACKETPROPERTY_GUID_YAW_ROTATION |
Angle du stylet à gauche ou à droite autour du centre de son axe horizontal lorsque le stylet est horizontal. Note: Cela nécessite un numériseur 3D. Si vous tenez le stylet devant vous et écrivez sur un mur imaginaire, zéro lacet indique que le stylet est perpendiculaire au mur. La valeur est négative si la pointe est à gauche de la perpendiculaire et positive si la pointe est à droite de la perpendiculaire. |
|
Largeur de la zone de contact sur un numériseur tactile. |
|
Hauteur de la zone de contact sur un numériseur tactile. |
|
Niveau de confiance qu’il y avait un contact avec le doigt sur un numériseur tactile. |
|
Identificateur de contact de l’appareil pour un paquet. |
Remarques
Notes
Toutes les valeurs de paquet provenant du matériel de la tablette sont des entiers de taille 32 bits.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows XP Édition Tablet PC [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Aucun pris en charge |
| En-tête |
|
Voir aussi