Méthode IInkPicture ::SetEventInterest (msinkaut.h)

Article
02/29/2024

Modifie une valeur qui indique si un objet ou un contrôle est intéressé par un événement spécifié.

Syntaxe

HRESULT SetEventInterest(
  [in] InkCollectorEventInterest EventId,
  [in] VARIANT_BOOL              Listen
);

Paramètres

[in] EventId

Événement à écouter. Les valeurs possibles pour eventID apparaissent dans le type d’énumération InkCollectorEventInterest .

[in] Listen

VARIANT_TRUE pour indiquer que l’événement est utilisé ; VARIANT_FALSE pour indiquer que l’événement est ignoré.

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_INVALIDARG	Intérêt d’événement non valide.
E_INK_EXCEPTION	Une exception s’est produite pendant le traitement.

Remarques

Tous les événements du collecteur d’encre peuvent être activés à l’aide de cette méthode. La plupart de ces événements sont désactivés par défaut pour des raisons de performances. Les seuls événements activés par défaut sont Stroke, CursorInRange et CursorOutOfRange.

Utilisez soigneusement les événements NewPackets, NewInAirPackets et CursorDown , en particulier parce qu’ils peuvent avoir un effet négatif sur les performances d’encre si trop de code est exécuté dans les gestionnaires d’événements.

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
Plateforme cible	Windows
En-tête	msinkaut.h
Bibliothèque	InkObj.dll