IInkOverlay ::GetGestureStatus, méthode (msinkaut.h)

Article
03/04/2024

Récupère une valeur qui détermine si l’objet InkCollector ou InkOverlay est intéressé par un mouvement d’application particulier.

Syntaxe

HRESULT GetGestureStatus(
  [in]          InkApplicationGesture Gesture,
  [out, retval] VARIANT_BOOL          *Listening
);

Paramètres

[in] Gesture

Mouvement dont vous souhaitez que le status.

[out, retval] Listening

VARIANT_TRUE si le contrôle InkCollector présente un intérêt pour un mouvement d’application particulier ; sinon, VARIANT_FALSE.

Cette méthode retourne une valeur qui indique l’intérêt de l’objet InkCollector ou InkOverlay dans un mouvement d’application connu. Si VARIANT_TRUE, l’objet InkCollector ou InkOverlay est intéressé par le mouvement et l’événement Gesture de l’objet InkCollector ou InkOverlay se déclenche lorsque le mouvement est reconnu.

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.
E_INK_INVALID_MODE	Le mode collection doit être en mode mouvement.
E_OUTOFMEMORY	Impossible d’allouer de la mémoire pour effectuer l’action.
E_INK_EXCEPTION	Une exception s'est produite.
E_INVALIDARG	L’indicateur n’est pas valide.

Remarques

Cette méthode lève une exception si le paramètre de mouvement est défini sur IAG_AllGestures.

Pour définir l’intérêt de l’objet InkCollector ou InkOverlay dans un mouvement particulier, appelez la méthode SetGestureStatus de l’objet InkCollector ou InkOverlay.

Note Par défaut, les objets InkCollector et InkOverlay n’ont aucun intérêt dans les mouvements de l’application.

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