僅 win32 (InkEdit 訊息)
InkEdit控制項是RichEdit控制項的超級類別。 每個 RichEdit 訊息都會直接在大部分情況下傳遞,且效果與 RichEdit完全相同。 這也適用于事件通知訊息。
若要傳送這些訊息,請使用下列參數呼叫 SendMessage 函式:
C++ |
---|
|
訊息
InkEdit控制項的父視窗會透過WM_NOTIFY訊息接收事件通知訊息:
LRESULT CALLBACK WindowProc(
HWND hWnd, // handle to window
UINT uMsg, // WM_NOTIFY
WPARAM wParam, // InkEdit control identifier
LPARAM lParam // see documentation for notification messages
);
取得/設定訊息 | Description |
---|---|
EM_GETINKMODE |
取得 InkEdit 控制項的筆跡模式。 參數: 此訊息沒有參數; wParam 和 lParam 必須是 0。 傳回值: 此訊息會傳回 InkMode 列舉中定義的其中一個值,這個值會指定是否停用筆跡收集、是否收集筆跡,或是否收集筆跡和手勢。 |
EM_SETINKMODE |
設定 InkEdit 控制項的筆跡模式。 參數: wParam指定 InkMode 列舉的其中一個值,指定是否停用筆跡集合、是否收集筆跡,或是否收集筆跡和手勢。 lParam不使用此參數;它必須是 0。 傳回值: 如果發生錯誤,則此訊息會傳回 0。如果發生錯誤,則傳回非零。 備註: 只有當EM_GETSTATUS傳回IES_Idle時,才應該使用此設定。 |
EM_GETINKINSERTMODE |
取得 InkEdit 控制項的筆跡 插入模式。 參數: 此訊息沒有參數; wParam 和 lParam 必須是 0。 傳回值: 此訊息會傳回 InkInsertMode 列舉的其中一個值,指定筆跡是插入控制項做為文字還是筆跡。 |
EM_SETINKINSERTMODE |
設定 InkEdit 控制項的筆跡 插入模式。 如果與安裝 Microsoft Windows XP Tablet PC Edition 以外的任何作業系統搭配使用,傳送此訊息就沒有任何作用。 參數: wParam指定 InkInsertMode 列舉的其中一個值,指定筆跡是插入控制項做為文字還是筆跡。 lParam不使用此參數;它必須是 0。 傳回值: 如果發生錯誤,則此訊息會傳回 0。如果發生錯誤,則傳回非零。 |
EM_GETDRAWATTR |
取得 InkEdit 控制項目前的繪圖屬性。 參數: wParam不使用此參數;它必須是 0。 lParam指定指標 (IInkDrawingAttributes **pDrawAttr) 接收目前的 InkDrawingAttributes 物件。 傳回值: 如果發生錯誤,則此訊息會傳回 0。如果發生錯誤,則傳回非零。 |
EM_SETDRAWATTR |
設定要用於未來筆跡集合的繪圖屬性。 參數: wParam不使用此參數;它必須是 0。 lParam指定 IInkDrawingAttributes *pDrawAttr) 至 InkDrawingAttributes 物件的 (指標。 傳回值: 如果發生錯誤,則此訊息會傳回 0。如果發生錯誤,則傳回非零。 |
EM_GETRECOTIMEOUT |
取得 InkEdit 控制項的辨識逾時,以毫秒為單位。 參數: 此訊息沒有參數; wParam 和 lParam 必須是 0。 傳回值: 此訊息會傳回辨識逾時,以毫秒為單位。 |
EM_SETRECOTIMEOUT |
設定 InkEdit 控制項的辨識逾時,以毫秒為單位。 參數: wParam指定辨識逾時,以毫秒為單位。 lParam不使用此參數;它必須是 0。 傳回值: 如果發生錯誤,則此訊息會傳回 0。如果發生錯誤,則傳回非零。 |
EM_GETGESTURESTATUS |
取得 InkEdit 控制項的筆勢狀態。 參數: wParam指定筆勢的類型,如 InkApplicationGesture 列舉中所定義。 lParam不使用此參數;它必須是 0。 傳回值: 如果 InkEdit 控制項訂閱筆勢,則此訊息會傳回 TRUE ;如果 InkEdit 控制項未訂閱筆勢,則傳回 FALSE 。 |
EM_SETGESTURESTATUS |
設定 InkEdit 控制項的筆勢狀態。 參數: wParam指定筆勢的類型,如 InkApplicationGesture 列舉中所定義。 lParam如果啟用訂閱手勢,則指定 TRUE ;如果未啟用接聽手勢,則指定 FALSE 。 傳回值: 如果發生錯誤,則此訊息會傳回 0。如果發生錯誤,則傳回非零。 備註: 只有當EM_GETSTATUS傳回IES_Idle時,才應該使用此設定。 |
EM_GETRECOGNIZER |
取得 InkEdit 控制項所使用的辨識器。 參數: wParam不使用此參數;它必須是 0。 lParam指定 IInkRecognizer* 的指標,以接收InkEdit控制項所使用的IInkRecognizer物件。 傳回值: 如果發生錯誤,則此訊息會傳回 0。如果發生錯誤,則傳回非零。 |
EM_SETRECOGNIZER |
設定 InkEdit 控制項所使用的辨識器。 如果 Factoid 用於 InkEdit 控制項,則必須在傳送此訊息之後重新套用它。 參數: wParam不使用此參數;它必須是 0。 lParam指定 IInkRecognizer* 的指標,以設定InkEdit控制項用於稍後使用的IInkRecognizer物件。 傳回值: 如果發生錯誤,則此訊息會傳回 0。如果發生錯誤,則傳回非零。 備註: 只有當EM_GETSTATUS傳回IES_Idle時,才應該使用此設定。 |
EM_GETFACTOID |
取得用於辨識的 Factoid 。 參數: wParam不使用此參數;它必須是 0。 lParam指定 BSTR 的指標,以接收事實字串。 傳回值: 如果發生錯誤,則此訊息會傳回 0。如果發生錯誤,則傳回非零。 |
EM_SETFACTOID |
將 Factoid 設定為用於辨識。 參數: wParam不使用此參數;它必須是 0。 lParam指定包含 factoid 字串的 BSTR。 傳回值: 如果發生錯誤,則此訊息會傳回 0。如果發生錯誤,則傳回非零。 備註: 只有當EM_GETSTATUS傳回IES_Idle時,才應該使用此設定。 |
EM_GETSELINK |
取得選取範圍中的筆跡。 必須先辨識筆跡,才能透過此訊息存取。 如果第一次無法辨識,EM_GETSELINK一律會傳回零 InkDisp 物件。 參數: wParam不使用此參數;它必須是 0。 lParam指定 VARIANT 的指標,以接收安全陣列,以接收目前選取範圍內 InkDisp 物件。 傳回值: 如果發生錯誤,則此訊息會傳回 0。如果發生錯誤,則傳回非零。 |
EM_SETSELINK |
設定選取範圍內的筆跡。 如果與 Windows XP Tablet PC Edition 以外的任何作業系統搭配使用,則傳送此訊息不會有任何作用。 參數: wParam不使用此參數;它必須是 0。 lParam指定具有 InkDisp 物件安全陣列之 VARIANT 的指標,以取代目前的選取範圍。 傳回值: 如果發生錯誤,則此訊息會傳回 0。如果發生錯誤,則傳回非零。 |
EM_GETSELINKDISPLAYMODE |
使用 InkDisplayMode 列舉的其中一個值,傳回所選範圍中筆跡的目前外觀。 參數: 此訊息沒有參數; wParam 和 lParam 必須是 0。 傳回值: 此訊息會傳回 InkDisplayMode 列舉 (IDM_Text或IDM_Ink) 的其中一個值,指定控制項上的選取專案顯示方式。 |
EM_SETSELINKDISPLAYMODE |
使用 InkDisplayMode 列舉的其中一個值,設定選取範圍中的筆跡外觀。 參數: wParam不使用此參數;它必須是 0。 lParam指定筆跡在選取範圍中的顯示方式,如 InkDisplayMode 列舉中所定義。 傳回值: 如果發生錯誤,則此訊息會傳回 0。如果發生錯誤,則傳回非零。 如果與 Windows XP Tablet PC Edition 以外的任何作業系統搭配使用,則傳送此訊息不會有任何作用。 |
EM_GETSTATUS |
取得 InkEdit 控制項的狀態。 參數: 此訊息沒有參數; wParam 和 lParam 必須是 0。 傳回值: 此訊息會傳回 InkEditStatus 列舉的其中一個值,指定控制項是否閒置、收集筆跡或辨識筆跡。 |
EM_RECOGNIZE |
強制辨識。 參數: 此訊息沒有參數; wParam 和 lParam 必須是 0。 傳回值: 如果發生錯誤,則此訊息會傳回 0。如果發生錯誤,則傳回非零。 |
EM_GETMOUSEICON |
取得滑鼠圖示。 參數: wParam不使用此參數;它必須是 0。 lParam指定填入目前 MouseIcon HICON 的 HICON* 指標。 此 HICON 可以是 HICON 或 Null 值。 傳回值: 如果發生錯誤,則此訊息會傳回 0。如果發生錯誤,則傳回非零。 |
EM_SETMOUSEICON |
設定滑鼠圖示。 參數: wParam如果 InkEdit 控制項應該擁有 HICON 控制碼,則指定 BOOLEAN 值 ,如果InkEdit 控制項不應該擁有 HICON 控制碼,則會設定為 TRUE 。 如果 InkEdit 控制項擁有 HICON,則會負責並適當地終結 HICON。 否則,呼叫端會擁有 HICON 並負責刪除它。 lParam指定新的 HICON 值。 使用 Null 來清除值。 預設值是 NULL。 傳回值: 如果發生錯誤,則此訊息會傳回 0。如果發生錯誤,則傳回非零。 |
EM_GETMOUSEPOINTER |
取得滑鼠指標。 參數: wParam不使用此參數;它必須是 0。 lParam包含已填入目前 MousePointer 值的 InkMousePointer* 指標。 這與 InkCollector::get_MousePointer 屬性的行為相同。 傳回值: 如果發生錯誤,則此訊息會傳回 0。如果發生錯誤,則傳回非零。 |
EM_SETMOUSEPOINTER |
設定滑鼠指標。 參數: wParam不使用此參數;它必須是 0。 lParam包含新的 MousePointer 值,這個值定義于 InkMousePointer 列舉中。 這與 InkCollector::p ut_MousePointer 屬性的行為相同。 傳回值: 如果發生錯誤,則此訊息會傳回 0。如果發生錯誤,則傳回非零。 |
EM_GETUSEMOUSEFORINPUT |
取得滑鼠輸入是否被視為手寫筆輸入的狀態。 參數: 此訊息沒有參數; wParam 和 lParam 必須是 0。 傳回值: 如果 為 FALSE ,則此訊息會傳回 0,如果為 TRUE,則傳回 1。 |
EM_SETUSEMOUSEFORINPUT |
設定滑鼠輸入是否被視為手寫筆輸入的狀態。 參數: wParam指定布林值,判斷是否要將滑鼠輸入視為手寫筆輸入。 lParam不使用此參數;必須是 0。 傳回值: 如果發生錯誤,則此訊息會傳回 0。 備註: 只有當EM_GETSTATUS傳回IES_Idle時,才應該使用這個值。 |
事件通知訊息 | Description |
---|---|
IECN_STROKE |
通知 InkEdit 控制項的父視窗已建立 IInkStrokeDisp 。 這會在具有下列參數的WM_NOTIFY訊息中傳送。 參數: wParam指定傳送訊息之控制項的識別碼。 lParam指定 IEC_STROKEINFO 結構的指標。 傳回值: 用戶端會傳回 0 以接受筆劃,而 1 表示取消筆劃。 |
IECN_GESTURE |
通知 InkEdit 控制項的父視窗已辨識手勢。 這會在具有下列參數的WM_NOTIFY訊息中傳送。 參數: wParam指定傳送訊息之控制項的識別碼。 lParam指定 IEC_GESTUREINFO 結構的指標。 傳回值: 用戶端會傳回 0 以接受手勢,而 1 表示取消手勢。 |
IECN_RECOGNITIONRESULT |
通知 InkEdit 控制項的父視窗已發生辨識。 這會在具有下列參數的WM_NOTIFY訊息中傳送。 參數: wParam指定傳送訊息之控制項的識別碼。 lParam指定 IEC_RECOGNITIONRESULTINFO 結構的指標。 傳回值: 如果用戶端處理訊息,用戶端會傳回 0。 |