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 |
|---|---|
|
Erfolg. |
|
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 |
|