Metodo ITablet::CreateContext

Articolo
06/13/2023

Crea un oggetto contesto che descrive il dispositivo tablet specificato.

Sintassi

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

Parametri

hWnd [in]

Finestra a cui verrà collegato il contesto del tablet.

prcInput [in]

[in, univoco]

Rettangolo di input penna.

dwOptions [in]

Contrassegni che impostano le opzioni di contesto del tablet.

pTCS [in]

[in, univoco]

Informazioni dettagliate sul contesto del tablet da creare.

cet [in]

Valore che abilita o disabilita l'invio dei messaggi di contesto alla finestra.

ppCtx [out]

Puntatore al contesto del tablet appena creato.

pTcid [in, out]

Valore che identifica in modo univoco il tablet.

ppPD [in, out]

Puntatore a informazioni sui dati contenuti in ogni pacchetto.

pSink [in]

Oggetto ITabletEventSink in cui verranno inviati messaggi di notifica.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_FAIL	Si è verificato un errore non specificato.

Commenti

In genere, un'applicazione ottiene i valori predefiniti dal metodo ITablet::GetDefaultContextSettings, modifica i valori in base alle proprie esigenze e quindi passa la struttura delle impostazioni modificate al metodo ITablet::CreateContext.

Nota

È necessario implementare l'interfaccia ITabletEventSink quando si chiama il metodo ITablet::CreateContext.

Il parametro dwOptions è un set di flag di bit che descrivono le opzioni di contesto. La tabella seguente descrive questi flag.

Nome flag	Valore	Descrizione
TCXO_MARGIN	0x00000001	Specifica che il contesto di input nel tablet avrà un margine. Il margine è un'area esterna all'area di input specificata in cui gli eventi verranno mappati al bordo dell'area di input. Questa funzionalità semplifica l'input dei punti al bordo del contesto.
TCXO_PREHOOK	0x00000002	Il prehook ottiene pacchetti prima di contesti regolari e posthook. Ottengono pacchetti nell'ordine della loro creazione.
TCXO_CURSOR_STATE	0x00000004	Il tc restituirà pacchetti anche se il cursore è su. Per impostazione predefinita, un tc restituirà solo pacchetti quando il cursore è inattivo.
TCXO_NO_CURSOR_DOWN	0x00000008	Il tc non restituirà pacchetti quando il cursore è inattivo.
TCXO_NON_INTEGRATED	0x00000010	Il contesto sarà non integrato.
TCXO_POSTHOOK	0x00000020	I posthook ottengono pacchetti dopo i normali contesti tablet, ma prima del contesto di sistema. Ottengono pacchetti nell'ordine inverso della loro creazione.
TCXO_DONT_SHOW_CURSOR	0x00000080	Il tc non imposta la posizione del cursore.
TCXO_DONT_VALIDATE_TCS	0x00000100	Tc non convalida il GUIDS passato nelle impostazioni del contesto del tablet rispetto alle proprietà supportate del dispositivo.
TCXO_ALLOW_FLICKS	0x00000400	Il tc consente di eseguire il rilevamento flick (per impostazione predefinita questa operazione è consentita solo nei contesti di sistema) e il client otterrà SE_FLICK eventi.
TCXO_ALLOW_FEEDBACK_TAPS	0x00000800	Tc consentirà di visualizzare il feedback della penna. Per impostazione predefinita, questa operazione è consentita solo nei contesti di sistema.
TCXO_ALLOW_FEEDBACK_BARREL	0x00001000	Tc consentirà di visualizzare il feedback della penna. Per impostazione predefinita, questa operazione è consentita solo nei contesti di sistema.
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	Tutte le opzioni di contesto del tablet definite.
TCXO_HOOK	TCXO_PREHOOK \| TCXO_POSTHOOK	Combina funzionalità pre-hook e post-hook.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Libreria	Wisptis.exe

Vedi anche

Interfaccia ITablet
Enumerazione CONTEXT_ENABLE_TYPE
Struttura TABLET_CONTEXT_SETTINGS
Struttura PACKET_DESCRIPTION
Interfaccia ITabletContextP
Interfaccia ITabletEventSink