IInkPicture ::p ut_InkEnabled, méthode (msinkaut.h)

Article
02/29/2024

Obtient ou définit une valeur qui spécifie si le contrôle InkPicture 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 put_InkEnabled(
  VARIANT_BOOL Collecting
);

Paramètres

Collecting

Valeur de retour

None

Remarques

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

Dans n’importe quelle édition de Windows 2000, Windows Server 2003 ou de Windows XP autre que Windows XP Édition Tablet PC, 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 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 de 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 estVARIANT_TRUE).

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

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’abord définie sur VARIANT_FALSE :

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

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