IInkOverlay::p ut_Enabled, méthode (msinkaut.h)

Article
08/24/2023

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

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

Syntaxe

HRESULT put_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.

Bien qu’un objet ne soit 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 des entrées manuscrites (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 Si vous définissez cette propriété dans certains gestionnaires de messages, la fonction sous-jacente peut être réinscrite, ce qui entraîne des résultats inattendus. Veillez à éviter un appel de réentrant lors de la gestion 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.

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 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