Méthode IInkCollector::get_Enabled (msinkaut.h)

Article
08/24/2023

Obtient ou définit une valeur qui spécifie si l’objet InkCollector collecte l’entrée du stylet (paquets en l’air, curseur dans les événements de plage, etc.).

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT get_Enabled(
  VARIANT_BOOL *Collecting
);

Paramètres

Collecting

Valeur de retour

None

Notes

Si le rectangle d’entrée de fenêtre d’un objet activé (défini dans le constructeur ou avec la méthode SetWindowInputRectangle ) d’un objet activé chevauche le rectangle d’entrée de fenêtre d’un autre objet activé, l’erreur E_INK_OVERLAPPING_INPUT_RECT est retournée. Le chevauchement peut se produire sans erreur tant qu’un seul des rectangles d’entrée est activé à un moment connu.

Si un objet n’est pas activé, vous ne recevez aucun événement.

Lorsqu’un contrôle de conteneur a sa propriété Enabled définie sur FALSE, tous ses contrôles contenus sont également désactivés.

Vous ne pouvez pas définir la propriété Enabled sur FALSE pendant que l’objet collecte l’encre (la propriété CollectingInk a la valeur TRUE).

Nous vous recommandons de définir Activé défini sur FALSE lorsque l’application s’arrête.

Note La définition de cette propriété dans certains gestionnaires de messages peut entraîner une nouvelle saisie de la fonction sous-jacente, ce qui entraîne des résultats inattendus. Veillez à éviter un appel de réentrée lors de la gestion de 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 des combinaisons de touches Alt-Tab ou Alt-Esc). Il s’agit d’un problème avec les applications de modèle d’appartement à thread unique.

Cette propriété doit avoir la valeur FALSE avant de définir ou d’appeler des propriétés et des méthodes spécifiques de l’objet. Si vous essayez de modifier les propriétés ou méthodes spécifiées, une erreur se produit. Les propriétés et méthodes suivantes ne peuvent pas être définies ou appelées, sauf si la propriété Enabled est d’abord définie sur FALSE :

Propriétés

Méthodes

Spécifications


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