InkEdit 控制項參考
InkEdit 控制項可讓您收集筆跡、辨識筆跡,以及將筆跡顯示為文字。 此控制項可讓您啟用智慧型表單,以改善文字輸入的精確度。
此控制項是 RichEdit 控制項的超集合。 它會擴充 RichEdit 控制項,並能夠擷取、辨識及顯示筆跡。
在 C++ 中呼叫 CoCreateInstance 方法,即可具現化此物件。
在透明控制項後方建立 InkEdit 控制項 (,例如已設定 WS_EX_TRANSPARENT 屬性的 GroupBox) 將會防止 InkEdit 收集筆跡。
成員
列舉型別 | 描述 |
---|---|
AppearanceConstants | 定義值,指定控制項是否顯示為平面或 3D。 |
BorderStyleConstants | 定義值,指定控制項是否有框線。 |
InkApplicationGesture | 定義一組應用程式特定手勢中設定興趣的值。 |
InkDisplayMode | 定義值,指定選取範圍是否顯示為筆跡或文字。 |
InkEditStatus | 定義值,指定 InkEdit 控制項是否閒置、收集筆跡或辨識筆跡。 |
InkInsertMode | 定義值,指定筆跡如何插入 InkEdit 控制項。 |
InkMode | 定義值,指定所繪製筆跡的收集模式設定,不論筆跡集合已停用、收集筆跡,還是收集筆跡和手勢。 |
InkMouseButton | 定義值,指定按下的滑鼠按鍵。 |
InkMousePointer | 定義值,指定出現的滑鼠指標類型。 |
MouseButton | 定義值,指定按下的滑鼠按鍵。 |
ScrollBarsConstants | 定義值,指定 InkEdit 控制項捲軸在畫面上顯示的方式。 |
SelAlignmentConstants | 定義值,指定段落相對於 InkEdit 控制項邊界的對齊方式。 |
事件通知訊息 | Description |
---|---|
IECN_STROKE | 當筆劃 (Win32 僅) 完成時,此訊息會透過WM_NOTIFY訊息傳送。 |
IECN_GESTURE | 當手勢完成 (Win32) 時,此訊息會透過WM_NOTIFY訊息傳送。 |
IECN_RECOGNITIONRESULT | 只有 win32 辨識 (Win32) 時,此訊息會透過WM_NOTIFY訊息傳送。 |
事件 | 描述 |
---|---|
改變 | 發生于控制項的內容或屬性值變更時。 |
按一下 | 發生於按下控制項時。 |
DblClick | 發生於按兩下控制項時。 |
手勢 | 發生于辨識應用程式手勢時。 |
KeyDown | 當使用者按下 InkEdit 控制項的焦點時按下按鍵時發生。 |
KeyPress | 當 InkEdit 控制項具有焦點時按下按鍵時發生。 |
KeyUp | 當 InkEdit 控制項具有焦點時放開按鍵時發生。 |
MouseDown | 發生于滑鼠指標位於 InkEdit 控制項上方且按下滑鼠按鍵時。 |
MouseMove | 發生于滑鼠指標移至 InkEdit 控制項上方時。 |
MouseUp | 發生于滑鼠指標位於 InkEdit 控制項上方且放開滑鼠按鍵時。 |
RecognitionResult | 當 InkEdit 控制項從呼叫 Recognize 方法手動取得結果,或在辨 識 逾時引發之後自動取得結果時發生。 |
SelChange | 發生于 InkEdit 控制項內的筆墨選取範圍變更時。 |
中風 | 發生于使用者在任何IInkTablet物件上繪製新的IInkStrokeDisp物件時。 |
取得/設定訊息 | Description |
---|---|
EM_GETINKMODE | 只取得控制項的筆跡模式 (Win32) 。 |
EM_SETINKMODE | 僅設定控制項的筆跡模式 (Win32) 。 |
EM_GETINKINSERTMODE | 只取得控制項的筆跡插入模式 (Win32) 。 |
EM_SETINKINSERTMODE | 僅設定控制項的筆跡插入模式 (Win32) 。 |
EM_GETDRAWATTR | 只取得控制項的目前繪圖屬性 (Win32) 。 |
EM_SETDRAWATTR | 將繪圖屬性設定為只用于未來的筆跡集合 (Win32) 。 |
EM_GETRECOTIMEOUT | 只取得控制項的辨識逾時 (Win32) 。 |
EM_SETRECOTIMEOUT | 僅設定控制項的辨識逾時 (Win32) 。 |
EM_GETGESTURESTATUS | 只取得控制項的手勢狀態 (Win32) 。 |
EM_SETGESTURESTATUS | 僅設定控制項的手勢狀態 (Win32) 。 |
EM_GETRECOGNIZER | 取得控制項只使用 (Win32) 的辨識器。 |
EM_SETRECOGNIZER | 設定控制項只使用 (Win32) 辨識器。 |
EM_GETFACTOID | 取得僅用於辨識 (Win32 的事實) 。 |
EM_SETFACTIOD | 將 factoid 設定為只用于辨識 (Win32) 。 |
EM_GETSELINK | 僅取得選取範圍中的筆跡 (Win32) 。 |
EM_SETSELINK | 僅) 設定選取範圍中的筆跡 (Win32。 |
EM_GETSELINKDISPLAYMODE | 使用 InkDisplayMode 列舉的其中一個值,只) 傳回所選取範圍中筆跡的目前外觀 (。 |
EM_SETSELINKDISPLAYMODE | 使用 InkDisplayMode 列舉的其中一個值, (Win32 只) 設定選取範圍中的筆跡外觀。 |
EM_GETSTATUS | 只取得 win32 (控制項的狀態) 。 |
EM_RECOGNIZE | 僅強制辨識 (Win32) 。 |
EM_GETMOUSEICON | 只取得 win32 (滑鼠圖示) 。 |
EM_SETMOUSEICON | 僅設定滑鼠圖示 (Win32) 。 |
EM_GETMOUSEPOINTER | 只取得 win32 (滑鼠指標) 。 |
EM_SETMOUSEPOINTER | 僅設定滑鼠指標 Win32) 。 |
EM_GETUSEMOUSEFORINPUT | 取得是否只將滑鼠輸入視為手寫筆輸入的狀態, (Win32) 。 |
EM_SETUSEMOUSEFORINPUT | 設定滑鼠輸入是否視為手寫筆輸入的狀態, (Win32 僅) 。 |
方法 | Description |
---|---|
GetGestureStatus | 取得已知筆勢集中 InkEdit 控制項的興趣。 |
Recognize | 指定應該進行辨識。 |
重新整理 | 使控制項重新繪製。 |
SetGestureStatus | 在一組已知的手勢中設定 InkEdit 控制項的興趣。 |
屬性 | Description |
---|---|
外觀 | 取得或設定值,這個值會決定 InkEdit 控制項是否顯示為平面或 3D。 |
BackColor | 取得或設定 InkEdit 控制項的背景色彩。 |
BorderStyle | 取得或設定值,判斷 InkEdit 控制項是否有框線。 |
DisableNoScroll | 取得或設定值,判斷 InkEdit 控制項中的捲軸是否停用。 |
DrawingAttributes | 取得或設定 InkEdit 控制項上尚未繪製之筆跡的繪圖屬性。 |
啟用 | 取得或設定值,判斷 InkEdit 控制項是否可以回應使用者產生的事件。 |
Factoid | 取得或設定IInkRecognizer物件用來限制其搜尋辨識結果的Factoid常數。 |
字型 | 取得或設定 InkEdit 控制項所顯示之文字的字型。 |
hWnd | 取得 InkDisp 控制項系結至其中的視窗控制碼。 |
InkInsertMode | 取得或設定值,指定筆跡如何插入 InkEdit 控制項,以文字或筆跡表示。 |
InkMode | 取得或設定值,這個值會指定是否停用筆跡集合、收集筆跡或收集筆跡和手勢。 |
已鎖定 | 取得或設定值,指定 InkEdit 控制項是否為唯讀。 |
MaxLength | 取得或設定值,指出 InkEdit 控制項是否可以保存最大數目的字元,如果是的話,則指定字元數上限。 |
MouseIcon | 取得或設定目前的自訂滑鼠圖示。 |
MousePointer | 取得或設定值,這個值表示滑鼠停留在 InkEdit 控制項的特定部分時出現的滑鼠指標類型。 |
MultiLine | 取得或設定值,這個值表示這是否為多行 InkEdit 控制項。 |
RecognitionTimeout | 取得或設定收集的最後 一個 IInkStrokeDisp 物件與文字辨識開頭之間的時間長度,以毫秒為單位。 |
辨識器 | 取得或設定要用於辨 識的 IInkRecognizer 物件。 |
ScrollBars | 取得或設定 InkEdit 控制項中顯示的捲軸類型。 |
SelAlignment | 取得或設定只套用至目前選取範圍或插入點的對齊方式, (執行時間) 。 |
SelBold | 取得或設定值,指定 InkEdit 控制項中目前選取文字的字型樣式是否為粗體 (執行時間) 。 |
SelCharOffset | 取得或設定 InkEdit 控制項中的文字是否出現在基準、上標或下標 (僅) 執行時間。 |
SelColor | 取得或設定目前文字選取範圍或插入點的文字色彩, (執行時間僅) 。 |
SelFontName | 取得或設定 InkEdit 控制項中所選文字的字型名稱, (執行時間僅) 。 |
SelFontSize | 取得或設定 InkEdit 控制項中所選文字的字型大小, (僅) 執行時間。 |
SelInks | 如果顯示為目前選取範圍的筆跡) ,則取得或設定內嵌 InkDisp 物件的陣列 (。 |
SelInksDisplayMode | 取得或設定值,這個值允許切換筆跡與文字之間的選取範圍外觀。 |
SelItalic | 取得或設定值,指定 InkEdit 控制項中目前選取文字的字型樣式是否為斜體 (執行時間) 。 |
SelLength | 取得或設定在 InkEdit 控制項中選取的字元數, (僅) 執行時間。 |
SelRTF | 會取得或設定目前選取的 RTF 格式 (RTF) 格式化的文字, (僅) 執行時間。 |
SelStart | 取得或設定在文字方塊中選取的文字起點, (僅) 執行時間。 |
SelText | 取得或設定 InkEdit 控制項內的選取文字, (執行時間) 。 |
SelUnderline | 取得或設定值,指定 InkEdit 控制項中目前選取文字的字型樣式是否只加上底線 (執行時間) 。 |
狀態 | 取得值,指定 InkEdit 控制項是否閒置、收集筆跡或辨識筆跡 (執行時間) 。 |
Text | 取得或設定文字方塊中目前的文字。 |
TextRTF | 取得或設定 InkEdit 控制項的文字,包括所有 RTF 程式碼。 |
UseMouseForInput | 取得或設定值,這個值表示滑鼠是否可以當做輸入裝置使用。 |
結構 | Description |
---|---|
IEC_STROKEINFO | 僅包含 Stroke 事件 (Win32) 的相關資訊。 |
IEC_GESTUREINFO | 僅包含特定手勢的相關資訊 (Win32) 。 |
IEC_RECOGNITIONRESULTINFO | 僅包含 win32 (辨識結果的相關資訊) 。 |
COM 實作
此物件會實作 IInkEdit COM 介面。