Méthode IInkTablet::GetPropertyMetrics (msinkaut.h)

Article
08/25/2023

Récupère les données de métriques pour une propriété spécifiée.

Syntaxe

HRESULT GetPropertyMetrics(
  [in]  BSTR                     propertyName,
  [out] long                     *Minimum,
  [out] long                     *Maximum,
  [out] TabletPropertyMetricUnit *Units,
  [out] float                    *Resolution
);

Paramètres

[in] propertyName

Propriété pour laquelle vous souhaitez déterminer les métriques.

Pour plus d’informations sur le type de données BSTR, consultez Utilisation de la bibliothèque COM.

[out] Minimum

Valeur minimale, en unités logiques, que la tablette signale pour cette propriété. Par exemple, une tablette signalant des valeurs x comprises entre 0 et 9 000 a un minimum logique de 0.

[out] Maximum

Valeur maximale, en unités logiques, que la tablette signale pour cette propriété. Par exemple, une tablette signalant des valeurs x comprises entre 0 et 9 000 aurait un maximum logique de 9 000.

[out] Units

Unités physiques de la propriété, telles que pouces ou degrés. Pour obtenir la liste des unités de propriété, consultez le type d’énumération TabletPropertyMetricUnit .

[out] Resolution

Spécifie la valeur de résolution ou d’incrémentation pour le membre d’unités . Par exemple, une tablette qui indique 400 points par pouce (ppp) a une valeur de résolution de 400.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Réussite.
TPC_E_UNKNOWN_PROPERTY	La tablette ne prend pas en charge la propriété spécifiée.
E_FAIL	Une erreur non spécifiée s'est produite.
E_POINTER	Un paramètre contenait un pointeur non valide.
CO_E_CLASSSTRING	Format GUID non valide.
E_INVALIDARG	Chaîne de propriété inconnue.
E_INK_EXCEPTION	Une exception s’est produite lors du traitement.

Notes

Les propriétés pour lesquelles vous récupérez des métriques peuvent inclure l’heure de génération d’un paquet ou la pression vers le bas de la pointe du stylet sur la surface de la tablette.

Pour obtenir la liste complète des propriétés pour lesquelles vous pouvez récupérer des métriques, consultez les constantes PacketProperty .

Note L’accès à cette propriété dans certains gestionnaires de messages peut entraîner la réentrée de la fonction sous-jacente, ce qui entraîne des résultats inattendus. Veillez à éviter un appel de réentrant lors du traitement des messages suivants : WM_ACTIVATE, WM_ACTIVATEAPP, WMNCACTIVATE, WM_PAINT ; WM_SYSCOMMAND si wParam est défini sur SC_HOTKEY ou SC_TASKLIST ; et WM_SYSKEYDOWN (lors du traitement Alt-Tab ou Alt-Esc combinaisons de touches). Il s’agit d’un problème avec les applications de modèle d’appartement à thread unique.

Spécifications


Client minimal pris en charge	Windows XP Édition Tablette PC [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	msinkaut.h
Bibliothèque	InkObj.dll