IInkPicture::get_InkEnabled méthode (msinkaut.h)

Article
03/08/2023
2 minutes de lecture

Obtient ou définit une valeur qui spécifie si le contrôle InkPicture collecte les entrées de stylet (paquets en air, curseur dans les événements de plage, etc.).

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

Syntaxe

HRESULT get_InkEnabled(
  VARIANT_BOOL *Collecting
);

Paramètres

Collecting

Valeur de retour

None

Notes

Le contrôle InkPicture collecte l’encre dans Windows Vista, Microsoft Windows XP Tablet PC Edition ou toute édition de Windows 2000, Windows Server 2003 ou Windows XP sur lequel le Kit de développement logiciel Windows XP Tablet PC Edition (SDK) est installé. Toutefois, la reconnaissance de l’écriture manuscrite se produit uniquement si Windows Vista, Windows XP Tablet PC Edition ou le Pack Recognizer est installé.

Dans n’importe quelle édition de Windows 2000, Windows Server 2003 ou Windows XP autre que Windows XP Tablet PC Edition, la propriété InkEnabled est toujours FALSE si le Kit de développement logiciel (SDK) Tablet PC n’est pas installé.

Si le rectangle d’entrée de fenêtre d’un objet activé (défini dans le constructeur ou avec la méthode SetWindowInputRectangle) chevauche le rectangle d’entrée de fenêtre d’un autre objet activé, l’erreur E_INK_OVERLAPPING_INPUT_RECT est retournée.

Note Le chevauchement peut se produire sans erreur tant qu’un seul des rectangles d’entrée n’est activé à tout moment.

Si le contrôle InkPicture n’est pas activé, vous ne recevez aucun événement.

Lorsque la propriété Enabled d’un contrôle InkPicture conteneur est définie sur VARIANT_FALSE, tous ses contrôles contenus sont également désactivés.

Vous ne pouvez pas définir cette propriété sur VARIANT_FALSE pendant que le contrôle InkPicture collecte l’encre (la propriété CollectingInk est VARIANT_TRUE).

Pour obtenir de meilleurs résultats, définissez la propriété Enabled sur VARIANT_FALSE lorsqu’une application s’arrête.

Cette propriété doit être définie sur VARIANT_FALSE avant de définir ou d’appeler des propriétés et des méthodes spécifiques du contrôle. Si vous essayez de modifier les propriétés spécifiées ou d’appeler les 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éfinie pour la première fois sur VARIANT_FALSE :

Propriétés :
Méthodes :
- SetAllTabletsMode, méthode
- SetSingleTabletIntegratedMode, méthode

Configuration requise


Client minimal pris en charge	Windows XP Tablet PC Edition [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