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 介面。

InkEdit 控制項參考

InkOverlay 類別