Méthode ITablet::CreateContext

Crée un objet de contexte qui décrit la tablette spécifiée.

Syntaxe

HRESULT CreateContext(
  [in]      HWND                    hWnd,
  [in]      RECT                    *prcInput,
  [in]      DWORD                   dwOptions,
  [in]      TABLET_CONTEXT_SETTINGS *pTCS,
  [in]      CONTEXT_ENABLE_TYPE     cet,
  [out]     ITabletContext          **ppCtx,
  [in, out] TABLET_CONTEXT_ID       *pTcid,
  [in, out] PACKET_DESCRIPTION      **ppPD,
  [in]      ITabletEventSink        *pSink
);

Paramètres

hWnd [in]

Fenêtre à laquelle le contexte de la tablette sera attaché.

prcInput [in]

[in, unique]

Rectangle d’entrée manuscrite.

dwOptions [in]

Indicateurs qui définissent les options de contexte de tablette.

pTCS [in]

[in, unique]

Informations détaillées sur le contexte de tablette à créer.

cet [in]

Valeur qui active ou désactive les messages de contexte envoyés à la fenêtre.

ppCtx [out]

Pointeur vers le contexte de tablette nouvellement créé.

pTcid [in, out]

Valeur qui identifie de manière unique la tablette.

ppPD [in, out]

Pointeur vers des informations sur les données contenues dans chaque paquet.

pSink [in]

Objet ITabletEventSink dans lequel les messages de notification seront envoyés.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Opération réussie.
E_FAIL	Une erreur non spécifiée s'est produite.

Notes

En règle générale, une application obtient les valeurs par défaut de la méthode ITablet::GetDefaultContextSettings, modifie les valeurs en fonction de ses besoins, puis transmet la structure de paramètres modifiée à la méthode ITablet::CreateContext.

Notes

Vous devez implémenter l’interface ITabletEventSink lors de l’appel de la méthode ITablet::CreateContext.

Le paramètre dwOptions est un ensemble d’indicateurs de bits qui décrivent les options de contexte. Le tableau suivant décrit ces indicateurs.

Nom de l’indicateur	Valeur	Description
TCXO_MARGIN	0x00000001	Spécifie que le contexte d’entrée sur la tablette aura une marge. La marge est une zone située en dehors de la zone d’entrée spécifiée où les événements seront mappés au bord de la zone d’entrée. Cette fonctionnalité facilite la saisie de points en périphérie du contexte.
TCXO_PREHOOK	0x00000002	Le préhook obtient des paquets avant les contextes et les posthooks normaux. Ils obtiennent des paquets dans l’ordre de leur création.
TCXO_CURSOR_STATE	0x00000004	Le tc retourne des paquets même si le curseur est en haut. Par défaut, un tc retourne uniquement les paquets lorsque le curseur est arrêté.
TCXO_NO_CURSOR_DOWN	0x00000008	Le tc ne retourne pas de paquets lorsque le curseur est arrêté.
TCXO_NON_INTEGRATED	0x00000010	Le contexte n’est pas intégré.
TCXO_POSTHOOK	0x00000020	Les posthooks obtiennent des paquets après les contextes de tablette standard, mais avant le contexte système. Ils obtiennent des paquets dans l’ordre inverse de leur création.
TCXO_DONT_SHOW_CURSOR	0x00000080	Le tc ne définit pas la position du curseur.
TCXO_DONT_VALIDATE_TCS	0x00000100	Le TC ne valide pas les GUID passés dans les paramètres de contexte de la tablette par rapport aux propriétés prises en charge de l’appareil.
TCXO_ALLOW_FLICKS	0x00000400	Le TC autorise la détection par glissement de page (par défaut, uniquement dans les contextes système), et le client obtient SE_FLICK événements.
TCXO_ALLOW_FEEDBACK_TAPS	0x00000800	Le TC permet d’afficher les commentaires du stylet. Par défaut, cela n’est autorisé que sur les contextes système.
TCXO_ALLOW_FEEDBACK_BARREL	0x00001000	Le TC permet d’afficher les commentaires du stylet. Par défaut, cela n’est autorisé que sur les contextes système.
TCXO_ALL	TCXO_MARGIN | TCXO_PREHOOK | TCXO_CURSOR_STATE | TCXO_NO_CURSOR_DOWN | TCXO_NON_INTEGRATED | TCXO_POSTHOOK | TCXO_DONT_SHOW_CURSOR | TCXO_DONT_VALIDATE_TCS	Toutes les options de contexte de tablette définies.
TCXO_HOOK	TCXO_PREHOOK | TCXO_POSTHOOK	Combine les fonctionnalités de pré-crochet et de post-crochet.

Spécifications

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
Bibliothèque	Wisptis.exe

Voir aussi

ITablet Interface

CONTEXT_ENABLE_TYPE, énumération

TABLET_CONTEXT_SETTINGS Structure

PACKET_DESCRIPTION Structure

ITabletContextP, interface

ITabletEventSink, interface