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

Article
03/04/2024

Détermine si une propriété d’une tablette ou d’une collection de tablettes, identifiées avec un identificateur global unique (GUID), est prise en charge. Par exemple, utilisez cette méthode pour déterminer si tous les comprimés d’une collection prennent en charge la pression tangentielle d’un stylet.

Syntaxe

HRESULT IsPacketPropertySupported(
  [in]          BSTR         packetPropertyName,
  [out, retval] VARIANT_BOOL *Supported
);

Paramètres

[in] packetPropertyName

GUID pour les GUID PacketProperty de la ou des tablettes demandées. Utilisez une constante BSTR définie à partir des constantes PacketProperty .

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

[out, retval] Supported

VARIANT_TRUE si une propriété connue est prise en charge par la ou les tablettes ; sinon, VARIANT_FALSE.

Note Cette méthode peut être réinscrite lorsqu’elle est appelée dans certains gestionnaires de messages, ce qui entraîne des résultats inattendus. Veillez à éviter un appel de réentrant lorsque vous gérez l’un des messages suivants : WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, 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.

Valeur retournée

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

Code de retour	Description
S_OK	Réussite.
E_POINTER	Un paramètre contenait un pointeur non valide.
CO_E_CLASSSTRING	Format GUID non valide.
E_INK_EXCEPTION	Une exception s’est produite lors du traitement.
E_INVALIDARG	L’indicateur n’est pas valide.

Remarques

Note Lorsque cette méthode est appelée sur la collection InkTablets , elle interroge toutes les tablettes du système. Si l’une d’elles ne prend pas en charge la propriété, elle retourne FALSE. Appelez IsPacketPropertySupported sur un objet IInkTablet individuel pour déterminer si l’appareil prend en charge une propriété connue.

Configuration requise

Condition requise	Valeur
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

Voir aussi

GetPacketData, méthode

IInkTablet, interface

SetPacketValuesByProperty, méthode

Partager via