ITablet::CreateContext メソッド

[アーティクル]
06/13/2023

指定したタブレットデバイスを記述するコンテキストオブジェクトを作成します。

構文

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

パラメーター

hWnd [in]

タブレットコンテキストがアタッチされるウィンドウ。

prcInput [in]

[入力、一意]

インク入力の四角形。

dwOptions [in]

タブレットコンテキストオプションを設定するフラグ。

pTCS [in]

[入力、一意]

作成するタブレットコンテキストに関する詳細情報。

cet [in]

ウィンドウに送信されるコンテキストメッセージを有効または無効にする値。

ppCtx [out]

新しく作成されたタブレットコンテキストへのポインター。

pTcid [in, out]

タブレットを一意に識別する値。

ppPD [in, out]

各パケットに含まれるデータに関する情報へのポインター。

pSink [in]

通知メッセージが送信される ITabletEventSink オブジェクト。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターンコード	説明
S_OK	成功しました。
E_FAIL	未指定のエラーが発生しました。

解説

通常、アプリケーションは ITablet::GetDefaultContextSettings メソッドから既定値を取得し、ニーズに合わせて値を変更してから、変更した設定構造を ITablet::CreateContext メソッドに渡します。

Note

ITablet::CreateContext メソッドを呼び出すときは、ITabletEventSink インターフェイスを実装する必要があります。

dwOptions パラメーターは、コンテキストオプションを記述するビットフラグのセットです。次の表では、これらのフラグについて説明します。

フラグ名	値	説明
TCXO_MARGIN	0x00000001	タブレットの入力コンテキストに余白を設定することを指定します。余白は、入力領域の端にイベントがマップされる、指定された入力領域の外側の領域です。この機能を使用すると、コンテキストの端にあるポイントを簡単に入力できます。
TCXO_PREHOOK	0x00000002	Prehook は、通常のコンテキストとポストフックの前にパケットを取得します。作成の順序でパケットを取得します。
TCXO_CURSOR_STATE	0x00000004	TC は、カーソルが上にある場合でもパケットを返します。既定では、TC はカーソルがダウンしている場合にのみパケットを返します。
TCXO_NO_CURSOR_DOWN	0x00000008	TC は、カーソルがダウンしているときはパケットを返しません。
TCXO_NON_INTEGRATED	0x00000010	コンテキストは統合されません。
TCXO_POSTHOOK	0x00000020	Posthook は、通常のタブレットコンテキストの後、システムコンテキストの前にパケットを取得します。パケットは、作成の逆の順序で取得されます。
TCXO_DONT_SHOW_CURSOR	0x00000080	TC はカーソル位置を設定しません。
TCXO_DONT_VALIDATE_TCS	0x00000100	TC は、タブレットコンテキスト設定で渡された GUID を、デバイスのサポートされているプロパティに対して検証しません。
TCXO_ALLOW_FLICKS	0x00000400	TC を使用すると、フリック検出が実行され (既定では、これはシステムコンテキストでのみ許可されます)、クライアントはSE_FLICKイベントを取得します。
TCXO_ALLOW_FEEDBACK_TAPS	0x00000800	TC を使用すると、ペンフィードバックを表示できます。既定では、これはシステムコンテキストでのみ許可されます。
TCXO_ALLOW_FEEDBACK_BARREL	0x00001000	TC を使用すると、ペンフィードバックを表示できます。既定では、これはシステムコンテキストでのみ許可されます。
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	定義されているすべてのタブレットコンテキストオプション。
TCXO_HOOK	TCXO_PREHOOK \|TCXO_POSTHOOK	プレフック機能とポストフック機能を組み合わせます。

要件

要件	値
サポートされている最小のクライアント	Windows XP タブレット PC エディション [デスクトップアプリのみ]
サポートされている最小のサーバー	サポートなし
ライブラリ	Wisptis.exe

次の方法で共有

ITablet::CreateContext メソッド

構文

パラメーター

戻り値

解説

要件

関連項目

フィードバック

その他のリソース