ITablet::CreateContext-Methode

Erstellt ein Kontextobjekt, das das angegebene Tablettgerä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 Tabletkontext angefügt wird.

prcInput [ In]

[in, unique]

Das Ink-Eingaberechteck.

dwOptions [ In]

Flags, die Tablet-Kontextoptionen festlegen.

pTCS [ In]

[in, unique]

Ausführliche Informationen zum zu erstellende Tablet-Kontext.

mess [ In]

Ein Wert, der das Senden von Kontextnachrichten an das Fenster aktiviert oder deaktiviert.

ppCtx [ out]

Ein Zeiger auf den neu erstellten Tabletkontext.

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 Benachrichtigungsmeldungen 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-Methodeab, ä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 ist ein Satz 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 auch dann zurück, wenn der Cursor hoch ist. Standardmäßig gibt ein TC nur Pakete zurück, wenn der Cursor ausgefallen ist.
TCXO _ NO _ CURSOR _ DOWN
0x00000008
Der TC gibt keine Pakete zurück, wenn der Cursor gedrückt 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 guids, die in den Tablet-Kontexteinstellungen übergeben werden, nicht anhand der unterstützten Eigenschaften des Geräts.
TCXO _ ALLOW _ FLICKS
0x00000400
Der TC lässt die Erkennung von Flimmern zu (dies ist standardmäßig nur in Systemkontexten zulässig), und der Client erhält SE _ FLICK-Ereignisse.
TCXO _ ALLOW _ FEEDBACK _ TAPS
0x00000800
Der TC lässt die Darstellung von Stiftfeedback zu. Standardmäßig ist dies nur in Systemkontexten zulässig.
TCXO _ ALLOW FEEDBACK _ _ (FEEDBACK ZU TCXO)
0x00001000
Der TC lässt die Darstellung von Stiftfeedback zu. Standardmäßig ist dies nur in Systemkontexten 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-Funktionen.

Requirements (Anforderungen)

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

Weitere Informationen

ITablet-Schnittstelle

CONTEXT _ ENABLE _ TYPE Enumeration

STRUKTUR _ DER _ TABLET-KONTEXTEINSTELLUNGEN

_PAKETBESCHREIBUNGsstruktur

ITabletContextP-Schnittstelle

ITabletEventSink-Schnittstelle