InkPicture 控制項參考
InkPicture 控制項可讓您在應用程式中放置影像，並讓使用者將筆跡新增至其中。 它適用于無法將筆跡辨識為文字，而是改為儲存為筆跡的案例。
在 C++ 中呼叫 CoCreateInstance 方法，即可具現化 InkPicture 控制項。
注意
InkPicture 控制項未標示為安全的腳本。 InkPicture 控制項不應該用於 HTML 或 ASP.NET 網頁。
在透明控制項後面建立 InkPicture 控制項 (，例如已設定WS_EX_TRANSPARENT屬性的 GroupBox，) 將會防止 InkPicture 收集筆跡。
成員
| 列舉型別 | 描述 |
|---|---|
| InkPictureSizeMode | 定義值，指定背景圖片在 InkPicture 控制項內的行為。 |
| 事件 | 描述 |
|---|---|
| ChangeUICues | 已取代。 |
| 按一下 | 發生于使用者按一下 InkPicture 控制項時。 |
| CursorButtonDown 事件 | 當 InkCollector 控制項偵測到關閉 的 IInkCursorButton 物件時發生。 |
| CursorButtonUp 事件 | 當 InkPicture 控制項偵測到已啟動 的 IInkCursorButton 時發生。 |
| CursorDown 事件 | 發生于游標提示接觸數位平板電腦表面時。 |
| CursorInRange 事件 | 發生于游標進入平板電腦內容 (鄰近性) 的實體偵測範圍時。 |
| CursorOutOfRange 事件 | 當游標離開平板電腦內容的實體偵測範圍 (鄰近性) 時發生。 |
| DblClick | 按兩下 InkPicture 控制項時發生。 這個事件方法定義在 _IInkPictureEvents 介面中。 _IInkPictureEvents介面會實作識別碼為 DISPID_IPEDblClick 的IDispatch介面。 |
| 手勢事件 | 發生于辨識應用程式手勢時。 |
| KeyDown 事件 [InkPicture 控制項] | 發生于按下按鍵並在 InkPicture 控制項具有焦點時位於向下位置時。 |
| KeyPress 事件[InkPicture 控制項] | 當 InkPicture 控制項具有焦點時按下按鍵時發生。 |
| KeyUp 事件 [InkPicture 控制項] | 當 InkPicture 控制項具有焦點時放開按鍵時發生。 |
| MouseDown 事件 [InkPicture 控制項] | 發生于滑鼠指標位於 InkPicture 控制項上方且按下滑鼠按鍵時。 |
| MouseEnter | 發生于滑鼠指標進入 InkPicture 控制項時。 |
| MouseHover | 發生于滑鼠指標停留在 InkPicture 控制項上方時。 |
| MouseLeave | 發生于滑鼠指標離開 InkPicture 控制項時。 |
| MouseMove 事件 [InkPicture 控制項] | 發生于滑鼠指標移至 InkPicture 控制項上方時。 |
| MouseUp 事件 [InkPicture 控制項] | 發生于滑鼠指標位於 InkPicture 控制項上方且放開滑鼠按鍵時。 |
| MouseWheel | 當 InkPicture 控制項具有焦點時，滑鼠滾輪移動時發生。 |
| NewInAirPackets 事件 | 發生于出現無線封包時。 |
| NewPackets 事件 | 當 InkPicture 控制項收到封包時發生。 |
| 畫 | 發生于 InkPicture 控制項完成重新繪製本身時。 |
| 繪畫 | 發生于 InkPicture 控制項重新繪製本身之前。 |
| 調整大小 | 發生于 InkPicture 控制項調整大小時。 |
| SelectionChanged | 發生于 InkPicture 控制項內的文字選取已變更時，例如透過變更使用者介面、剪下和貼上程式或 Selection 屬性。 |
| SelectionChanging | 當 InkPicture 控制項內的文字選取即將變更時發生，例如透過變更使用者介面、剪下和貼上程式或 Selection 屬性。 |
| SelectionMoved | 發生于目前選取範圍的位置已變更時，例如透過變更使用者介面、剪下和貼上程式或 Selection 屬性。 |
| SelectionMoving 事件 [InkPicture 控制項] | 發生于目前選取範圍的位置即將變更時，例如透過變更使用者介面、剪下和貼上程式或 Selection 屬性。 |
| SelectionResized | 發生于目前選取範圍的大小變更時，例如透過變更使用者介面、剪下和貼上程式或 Selection 屬性。 |
| SelectionResizing | 發生于目前選取範圍的大小即將變更時，例如透過變更使用者介面、剪下和貼上程式或 Selection 屬性。 |
| SizeChanged | 發生于 InkPicture 控制項調整大小之後，特別是 當 Width 或 Height 屬性值變更之後。 |
| SizeModeChanged | 發生于 InkPicture 控制項的 SizeMode 屬性變更之後。 |
| StyleChanged | 未實作。 |
| 中風 | 發生于使用者在任何平板電腦上繪製新的筆劃時。 |
| StrokesDeleted | 發生于從Ink屬性刪除IInkStrokeDisp物件之後。 |
| StrokesDeleting | 發生于從Ink屬性刪除IInkStrokeDisp物件之前。 |
| SystemColorsChanged | 發生于系統色彩變更之後。 |
| SystemGesture | 發生于辨識系統手勢時。 |
| TabletAdded 事件 | 當平板電腦新增至系統時發生。 |
| TabletRemoved 事件 | 從系統移除平板電腦時發生。 |
| 方法 | Description |
|---|---|
| GetEventInterest 方法 | 傳回值，這個值表示 InkPicture 控制項是否對特定事件感興趣。 |
| GetGestureStatus | 傳回值，指出 InkPicture 控制項是否對特定應用程式手勢感興趣。 |
| GetWindowInputRectangle 方法 | 傳回繪製筆跡的視窗矩形，以圖元為單位。 |
| HitTestSelection | 會傳回 SelectionHitResult 列舉的成員，指定在點擊測試期間叫用選取範圍的哪個部分。 |
| SetAllTabletsMode 方法 | 可讓 InkPicture 控制項從連接至平板電腦的任何平板電腦收集筆跡。 |
| SetEventInterest 方法 | 設定值，這個值表示 InkPicture 控制項是否對指定的事件感興趣。 |
| SetFocus | 將焦點移至 InkPicture 控制項。 |
| SetGestureStatus 方法 | 在指定的應用程式手勢中設定 InkPicture 物件的興趣。 |
| SetSingleTabletIntegratedMode 方法 | 設定 InkPicture 控制項，只從連接至平板電腦的一部平板電腦收集筆跡。 會忽略來自其他平板電腦的筆跡。 |
| SetWindowInputRectangle 方法 | 指定要在其中繪製筆跡的視窗座標中設定的視窗矩形。 |
| ShowWhatsThis | 使用 [說明] 在 32 位 Microsoft Windows 作業系統中提供的 [說明] 快顯視窗，在 [說明] 檔案中顯示選取的主題， (僅限設計階段) 。 |
| ZOrder | 將控制項放在圖形化層級的前面或後方， (設計階段僅) 。 |
| 屬性 | Description |
|---|---|
| AutoRedraw 屬性 | 取得或設定值，指定當視窗失效時，InkPicture 控制項是否 (當與 InkPicture 控制項相關聯的 InkDisp 物件是否自動重新繪製與 InkPicture 控制項相關聯的視窗收到) WM_PAINT訊息。 |
| BackColor | 取得或設定 InkPicture 控制項的背景色彩。 預設背景色彩是系統視窗背景色彩，通常是白色。 |
| CollectingInk 屬性 | 取得值，這個值會指定 InkPicture 控制項是否只收集筆跡 (執行時間) 。 |
| CollectionMode | 取得或設定集合模式，判斷筆跡、手勢或筆跡和筆跡和筆勢是否可辨識為使用者寫入。 |
| Cursors 屬性 | 取得可用於 InkPicture 控制項筆跡區域的 IInkCursors 集合。 |
| CustomStrokes | 取得要與筆跡一起保存的 IInkCustomStrokes 集合 (僅限設計階段) 。 |
| DefaultDrawingAttributes 屬性 | 取得或設定預設 InkDrawingAttributes 集合，以在只繪製和顯示筆跡 (執行時間時使用) 。 |
| DesiredPacketDescription 屬性 | 取得或設定 InkPicture 控制項的封包描述， (執行時間僅) 。 |
| DynamicRendering 屬性 | 取得或設定值，指定 InkPicture 控制項是否在收集筆跡時動態呈現。 |
| EditingMode | 取得或設定值，指定 InkPicture 控制項是否處於筆跡模式、刪除模式或選取/編輯模式。 |
| 啟用 | 取得或設定值，判斷 InkPicture 控制項是否可以回應使用者產生的事件。 注意： 這個屬性相當於 InkEnabled 屬性。 |
| EraserMode | 取得或設定值，指定筆墨是透過筆劃或點清除。 |
| EraserWidth | 取得或設定值，指定橡皮擦筆尖的寬度。 |
| hWnd | 取得 InkPicture 控制項所系結的視窗控制碼。 僅) (執行時間 |
| 筆跡 | 會取得或設定與 InkPicture 控制項相關聯的 InkDisp 物件， (執行時間) 。 |
| InkEnabled | 取得或設定值，指定 InkPicture 控制項是否收集手寫筆輸入 (無線封包、範圍事件中的資料指標等等) 。 |
| MarginX 屬性 | 取得或設定螢幕座標中視窗矩形周圍的 X 軸邊界。 |
| MarginY 屬性 | 取得或設定螢幕座標中視窗矩形周圍的 Y 軸邊界。 |
| MouseIcon 屬性 | 取得或設定目前的自訂滑鼠圖示。 |
| MousePointer 屬性 | 取得或設定值，這個值表示滑鼠停留在 InkPicture 控制項的特定部分時出現的滑鼠指標類型。 |
| 圖片 | 取得要出現在 InkPicture 控制項上的圖形檔案。 |
| Renderer 屬性 | 會取得或設定 InkRenderer 物件，該物件用來在 InkPicture 控制項上繪製筆跡 (執行時間) 。 |
| 選取項目 | 取得目前在 InkPicture 控制項內選取的 InkStrokes 集合， (僅) 執行時間。 |
| SizeMode | 取得或設定 控制項如何處理影像放置和調整大小。 |
| SupportHighContrastInk 屬性 | 取得值，這個值會指定當系統處於高對比模式時，筆跡是否只轉譯為一種色彩，Color = COLOR_WINDOWTEXT (從 GetSystemMetrics 呼叫) 。 |
| SupportHighContrastSelectionUI | 取得或設定值，這個值會指定當系統處於高對比模式時，是否以高對比模式繪製所有選取使用者介面 (選取範圍周框方塊和選取控) 點。 |
| Tablet 屬性 | 取得 InkPicture 控制項目前用來收集輸入的 IInkTablet 物件。 |
備註
InkPicture 控制項的執行時間使用者介面是一個視窗，其中包含不透明背景 (單一色彩、圖片背景，或包含不透明筆跡的兩者) 。
您可以使用 InkPicture 控制項在 Microsoft Windows 2000、Windows Server 2003、Windows XP 平板電腦版本以外的任何 Windows XP 版本，以及任何版本的 Windows Vista 中轉譯筆跡。 不過，您只能在下列情況下輸入筆跡、接受手勢或辨識手寫：
- 如果已安裝 Windows Vista 或 XP Tablet PC Edition 2005，則筆跡可以輸入並辨識。
- 也可以辨識手勢。
- 如果手寫源自于執行舊版 Windows 的機器上，只要辨識器存在，手寫就可以辨識為文字。
如果您使用 Windows 2000、Windows Server 2003、Windows XP 平板電腦版本 2005 以外的任何 Windows XP 版本，您可以將值指派給 InkPicture 控制項的環境屬性，然後將筆跡複製並貼到其他應用程式。 不過，其 InkEnabled 屬性的值一律為 FALSE。
保存的 InkDisp 物件可以載入並顯示在所有 Windows Vista 和 XP 版本，以及只有已安裝 Windows XP 平板電腦電腦版軟體發展工具組的系統上， (SDK) 。 如果已安裝 Windows Vista 或 Windows XP Tablet PC Edition 2005，InkDisp物件只能轉換成可辨識) (文字。
如果此控制項上的作業不成功，則會傳回合法的 HRESULT。 如果發生錯誤狀況，請檢查傳回的 HRESULT 是否有錯誤。
如需筆跡控制項的詳細資訊，請參閱 Ink。
如需哪些執行緒引發特定事件的相關資訊，請參閱事件 可以引發的執行緒。
若要改善應用程式的效能，請在不再需要 InkPicture 控制項時手動處置。
注意
當 InkPicture 控制項與另一個控制項重迭時，例如 GroupBox 設為透明時，InkPicture 將不會收集筆跡。 InkPicture 必須是 Z 順序中最上層的控制項，或者必須是 GroupBox的子系。
COM 實作
這個物件會實作 IInkPicture COM 介面。