ITablet：：CreateCoNtext 方法
建立描述指定平板電腦裝置的內容物件。
語法
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]
-
[in， unique]
筆跡輸入矩形。
-
dwOptions [in]
-
設定平板電腦內容選項的旗標。
-
pTCS [in]
-
[in， unique]
要建立之平板電腦內容的詳細資訊。
-
cet [in]
-
啟用或停用傳送至視窗之內容訊息的值。
-
ppCtx [out]
-
新建立平板電腦內容的指標。
-
pTcid [in， out]
-
可唯一識別平板電腦的值。
-
ppPD [in， out]
-
每個封包中所含資料相關資訊的指標。
-
pSink [in]
-
將傳送通知訊息的 ITabletEventSink 物件。
傳回值
這個方法可以傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
成功。 |
|
發生未指定的錯誤。 |
備註
一般而言，應用程式會從 ITablet：：GetDefaultCoNtextSettings 方法取得預設值、修改值以符合其需求，然後將修改過的設定結構傳遞至 ITablet：：CreateCoNtext 方法。
注意
呼叫ITablet：：CreateCoNtext 方法時，您必須實作ITabletEventSink 介面。
dwOptions參數是描述內容選項的一組位旗標。 下表描述這些旗標。
| 旗標名稱 | 值 | Description |
|---|---|---|
| TCXO_MARGIN |
0x00000001 |
指定平板電腦上的輸入內容會有邊界。 邊界是指定輸入區域以外的區域，其中事件會對應至輸入區域的邊緣。 這項功能可讓您更輕鬆地在內容邊緣輸入點。 |
| TCXO_PREHOOK |
0x00000002 |
預先hook 會在一般內容和後置hook 之前取得封包。 他們會依建立的順序取得封包。 |
| 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 Tablet PC Edition [僅限傳統型應用程式] |
| 最低支援的伺服器 |
都不支援 |
| 程式庫 |
|