Partager via


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

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

Voir aussi

Événement CursorDown

Événement CursorInRange

GetEventInterest, méthode

IInkPicture

InkCollectorEventInterest, énumération

Inkpicture

Événement NewPackets

Événement stroke