共用方式為

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 事件 發生於從系統移除平板電腦時。
方法 描述
GetEventInterest 方法 傳回值，指出 InkPicture 控制件是否對特定事件感興趣。
GetGestureStatus 傳回值，指出 InkPicture 控制件是否對特定應用程式手勢感興趣。
GetWindowInputRectangle 方法 傳回以像素為單位繪製筆跡的視窗矩形。
HitTestSelection 會傳回 SelectionHitResult 列舉的成員，指定在點擊測試期間叫用選取範圍的哪個部分。
SetAllTabletsMode 方法 可讓 InkPicture 控制件從連接至平板電腦的任何平板電腦收集筆跡。
SetEventInterest 方法 設定值，這個值表示 InkPicture 控制件是否對指定的事件感興趣。
SetFocus 將焦點移至 InkPicture 控制件。
SetGestureStatus 方法 在指定的應用程式手勢中設定 InkPicture 對象的興趣。
SetSingleTabletIntegratedMode 方法 將 InkPicture 控制項設定為僅從一部連接至平板電腦的平板電腦收集筆跡。 忽略其他平板電腦中的筆跡。
SetWindowInputRectangle 方法 指定要在視窗座標中設定的視窗矩形，在其中繪製筆跡。
ShowWhatsThis 使用 32 位Microsoft Windows作系統的 [說明] 提供的 [說明] 快顯，在 [說明] 檔案中顯示選取的主題（僅限設計時間）。
ZOrder 將控件放在圖層順序的前面或背面，在其圖形層級內（僅限設計時間）。
財產 描述
AutoRedraw 屬性 取得或設定值，指定當視窗失效時，InkPicture 控件是否會重新繪製（當與 InkPicture 控件關聯的視窗收到WM_PAINT訊息時，是否會自動重繪目前與 InkPicture 控件關聯的 InkDisp 物件）。
BackColor 取得或設定 InkPicture 控制件的背景色彩。 默認背景色彩是系統視窗背景色彩，通常是白色。
CollectingInk 屬性 取得值，指定 InkPicture 控制項是否正在收集筆跡（僅限運行時間）。
CollectionMode 取得或設定集合模式，這個模式會決定使用者寫入時，是否可辨識筆跡、手勢或筆跡和筆勢。
Cursors 屬性 取得 IInkCursors 集合，可用於 InkPicture 控件的筆跡區域。
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 控制件上的圖形檔案。
轉譯器屬性 取得或設定用來在 InkPicture 控制件上繪製筆跡的 InkRenderer 物件（僅限運行時間）。
選取範圍 取得目前在 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 平板電腦版本 2005，則 InkDisp 物件只能轉換成文字（已辨識）。

如果此控件上的作業不成功，則會傳回合法的 HRESULT。 如果錯誤狀況結果，請檢查傳回的 HRESULT 是否有錯誤。

如需筆跡控制件的詳細資訊，請參閱 Ink。

如需哪些線程引發特定事件的詳細資訊，請參閱 事件可以引發的線程。

若要改善應用程式的效能，請在不再需要 InkPicture 控件時手動處置。

注意

當 InkPicture 控制件與另一個控件重疊時，例如 GroupBox 設為透明，InkPicture 將不會收集筆跡。 InkPicture 必須是 Z 順序中最上層的控件，或者它必須是 GroupBox的子系。

COM 實作

此物件會實作 IInkPicture COM 介面。

InkEdit 控制件參考

InkOverlay 類別