ITablet::CreateContext-Methode

Artikel
06/13/2023

Erstellt ein Kontextobjekt, das das angegebene Tablet-Gerät beschreibt.

Syntax

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

Parameter

hWnd [in]

Das Fenster, an das der Tablet-Kontext angefügt wird.

prcInput [in]

[in, eindeutig]

Das Freihandeingaberechteck.

dwOptions [in]

Flags, die Tablet-Kontextoptionen festlegen.

pTCS [in]

[in, eindeutig]

Detaillierte Informationen zum zu erstellenden Tablet-Kontext.

cet [in]

Wert, der kontextbezogene Nachrichten, die an das Fenster gesendet werden, aktiviert oder deaktiviert.

ppCtx [out]

Ein Zeiger auf den neu erstellten Tablet-Kontext.

pTcid [in, out]

Wert, der das Tablet eindeutig identifiziert.

ppPD [in, out]

Zeiger auf Informationen darüber, welche Daten in den einzelnen Paketen enthalten sind.

pSink [in]

Das ITabletEventSink-Objekt , an das Benachrichtigungen gesendet werden.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	Beschreibung
S_OK	Erfolg.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.

Bemerkungen

In der Regel ruft eine Anwendung die Standardwerte von der ITablet::GetDefaultContextSettings-Methode ab, ändert Werte entsprechend ihren Anforderungen und übergibt dann die geänderte Einstellungsstruktur an die ITablet::CreateContext-Methode.

Hinweis

Sie müssen die ITabletEventSink-Schnittstelle implementieren, wenn Sie die ITablet::CreateContext-Methode aufrufen.

Der dwOptions-Parameter besteht aus einer Reihe von Bitflags, die Kontextoptionen beschreiben. In der folgenden Tabelle werden diese Flags beschrieben.

Flagname	Wert	Beschreibung
TCXO_MARGIN	0x00000001	Gibt an, dass der Eingabekontext auf dem Tablet einen Rand hat. Der Rand ist ein Bereich außerhalb des angegebenen Eingabebereichs, in dem Ereignisse dem Rand des Eingabebereichs zugeordnet werden. Dieses Feature erleichtert die Eingabe von Punkten am Rand des Kontexts.
TCXO_PREHOOK	0x00000002	Prehook ruft Pakete vor regulären Kontexten und Posthooks ab. Sie erhalten Pakete in der Reihenfolge ihrer Erstellung.
TCXO_CURSOR_STATE	0x00000004	Der TC gibt Pakete zurück, auch wenn der Cursor aktiviert ist. Standardmäßig gibt ein TC Pakete nur zurück, wenn der Cursor ausgefallen ist.
TCXO_NO_CURSOR_DOWN	0x00000008	Der TC gibt keine Pakete zurück, wenn der Cursor ausgefallen ist.
TCXO_NON_INTEGRATED	0x00000010	Der Kontext ist nicht integriert.
TCXO_POSTHOOK	0x00000020	Posthooks erhalten Pakete nach regulären Tablet-Kontexten, aber vor dem Systemkontext. Sie erhalten Pakete in der umgekehrten Reihenfolge ihrer Erstellung.
TCXO_DONT_SHOW_CURSOR	0x00000080	Der TC legt die Cursorposition nicht fest.
TCXO_DONT_VALIDATE_TCS	0x00000100	Der TC überprüft die in den Tablet-Kontexteinstellungen übergebene GUIDS nicht anhand der unterstützten Eigenschaften des Geräts.
TCXO_ALLOW_FLICKS	0x00000400	Der TC ermöglicht die Flickerkennung (standardmäßig ist dies nur für Systemkontexte zulässig), und der Client erhält SE_FLICK Ereignisse.
TCXO_ALLOW_FEEDBACK_TAPS	0x00000800	Der TC ermöglicht die Darstellung des Stiftfeedbacks. Standardmäßig ist dies nur für Systemkontexte zulässig.
TCXO_ALLOW_FEEDBACK_BARREL	0x00001000	Der TC ermöglicht die Darstellung des Stiftfeedbacks. Standardmäßig ist dies nur für Systemkontexte zulässig.
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	Alle definierten Tablet-Kontextoptionen.
TCXO_HOOK	TCXO_PREHOOK \| TCXO_POSTHOOK	Kombiniert Pre-Hook- und Post-Hook-Funktionalität.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Bibliothek	Wisptis.exe

Weitere Informationen

ITablet-Schnittstelle
CONTEXT_ENABLE_TYPE-Enumeration
TABLET_CONTEXT_SETTINGS-Struktur
PACKET_DESCRIPTION-Struktur
ITabletContextP-Schnittstelle
ITabletEventSink-Schnittstelle

Freigeben über