Windows.UI.Input.Inking 命名空間

提供 Windows Ink 應用程式的輸入、處理和管理支援。 這包括:

  • 繪製筆墨筆劃。
  • 擷取筆劃。
  • 轉譯筆劃。
  • 選取筆劃。
  • 刪除筆劃。
  • 儲存和載入筆劃。
  • 透過手寫辨識將筆劃轉換成文字。
  • 從剪貼簿複製和貼上筆劃。
  • 點擊測試 (或筆劃目標) 。

類別

InkDrawingAttributes

提供與 InkStroke 繪圖相關聯的屬性。

InkDrawingAttributesPencilProperties

提供一組靜態 InkDrawingAttributes 屬性,以轉譯 InkCanvas 上的鉛筆筆劃。

呼叫 InkDrawingAttributes.CreateForPencil 並存取 InkDrawingAttributes.PencilProperties,以取得此類別的實例。

InkInputConfiguration

管理 InkPresenter 物件可以處理哪些類型的次要輸入。

InkInputProcessingConfiguration

管理 InkPresenter 對象處理輸入的方式。

InkManager

注意

針對使用可延伸應用程式標記語言的通用 Windows 應用程式 (XAML) ,我們建議使用 InkPresenterInkCanvas 控件,而不是 InkManager。

管理輸入、操作和處理 (,包括一或多個 InkStroke 物件的手寫辨識) 。

InkModelerAttributes

管理 InkPresenter 物件可以處理哪些類型的筆跡模型工具屬性。

InkPoint

提供用於 建構 InkStroke 之單一點的原始輸入數據。

InkPresenter

提供屬性、方法和事件,以管理 InkCanvas 控件的輸入、處理和轉譯 (標準和修改的) 。

InkPresenterProtractor

代表視覺樣板,以繪製弧形和曲線的縮圖形式,顯示為 InkCanvas 上的半透明重疊。

樣板會轉換筆墨筆劃的呈現方式:

  • 如果畫筆筆尖位於距離閾值內 (線) ,則會將筆墨筆劃貼齊樣板邊緣。
  • 它會做為遮罩,並防止在樣板遮蔽的區域內繪製筆墨筆劃。

InkPresenterRuler 可以透過程序設計方式和使用者操作。 它也會使用 InkCanvas 來調整和轉譯。

InkPresenterRuler

表示可視化樣板,以直線繪製直線的直線規則形式,顯示為 InkCanvas 上的半透明重疊。

樣板會轉換筆墨筆劃的呈現方式:

  • 如果畫筆筆尖位於距離閾值內 (線) ,則會將筆墨筆劃貼齊樣板邊緣。
  • 它會做為遮罩,並防止在樣板遮蔽的區域內繪製筆墨筆劃。

InkPresenterRuler 可以透過程序設計方式和使用者操作。 它也會使用 InkCanvas 來調整和轉譯。

InkRecognitionResult

提供屬性和方法來管理 InkStroke 手寫識別數據。

InkRecognizer 偵測到的每個單字都會產生辨識結果。

InkRecognizer

管理手寫辨識的所有層面。

InkRecognizerContainer

提供屬性和方法來管理用於手寫辨識的一或多個 InkRecognizer 物件。

如果系統上沒有辨識引擎,InkRecognizerContainer 為 Null。

InkStroke

單一筆墨筆劃,包括用於筆劃最終轉譯的 Bézier 曲線參數。

InkStrokeBuilder

從原始指標輸入建置筆劃。

注意

針對使用可延伸應用程式標記語言的通用 Windows 應用程式 (XAML) ,我們建議使用 InkPresenterInkCanvas 控件,而不是 InkManager

使用 CreateStrokeFromInkPointsSetDefaultDrawingAttributes 以程式設計方式建置 InkPresenter 的筆劃。

InkStrokeContainer

提供屬性和方法來儲存及管理 InkPresenter 所呈現之 InkStroke 物件的集合。

對筆劃容器中任何筆墨筆劃所做的修改會立即轉譯為與 InkPresenter 相關聯的繪圖介面。

InkStrokeInput

提供與 InkPresenter 對象相關聯的 StrokeInput 屬性和事件。

InkStrokeRenderingSegment

完整筆墨筆劃的單一線段。

單一區段包含起點、結束點和兩個 Bezier 控制點。 不過,針對構成筆劃的一系列線段,上一個線段的最後一個點是目前線段的第一個點。 這表示只需要每個線段的結束點,才能代表完整的筆劃。

每個筆劃都是 InkStrokeRenderingSegment 物件的向量,其中第一個線段是由單一起點識別,以及由結束點和兩個 Bezier 控制點所識別的所有剩餘區段。

InkStrokesCollectedEventArgs

包含與 InkCanvas 控件相關聯之 InkPresenter之 StrokesCollected 事件的事件數據。

根據預設,筆墨筆劃會在低延遲的背景線程上處理,並在繪製時呈現為濕度。 當筆劃完成 (畫筆或手指隨即放開,或放開滑鼠按鈕) 時,會在UI線程上處理筆劃,並將筆劃轉譯為 InkCanvas 層 (上方的應用程式內容) 。 如果UI線程忙碌中,當線程可供使用時,可能會處理多個筆墨筆劃 (收集) 。

在載入 InkCanvas 之前呼叫 ActivateCustomDrying 方法,即可覆寫此行為。

InkStrokesErasedEventArgs

包含與 InkCanvas 控件相關聯之 InkPresenter之 StrokesErased 事件的事件數據。

根據預設,筆墨筆劃數據和轉譯完全由 InkCanvas 控件管理。 不過,在載入 InkCanvas 之前呼叫 ActivateCustomDrying 方法,即可覆寫此行為。

InkSynchronizer

管理筆跡輸入的同步處理,並提供將它轉譯至通用 Windows 應用程式的 Direct2D 裝置內容的方法,而不是預設的 InkCanvas 控件。 這需要 IInkD2DRenderer 物件來管理筆跡輸入 (請參閱 複雜筆跡範例) 。

根據預設,筆墨輸入是在低延遲背景執行緒上處理,並在其繪製期間轉譯為「濕潤」狀態。 完成筆劃 (拿起畫筆或手指,或是放開滑鼠按鈕) 時,即會在 UI 執行緒上處理該筆劃,並以「烘乾」狀態轉譯到 InkCanvas 層級 (在應用程式內容上方,並取代濕潤的筆墨)。

藉由呼叫 ActivateCustomDrying (在載入 InkCanvas 之前),app 會建立 InkSynchronizer 物件,來自訂如何將筆墨筆劃以烘乾狀態轉譯到 SurfaceImageSourceVirtualSurfaceImageSource。 例如,筆墨筆劃會被點陣化並整合到應用程式內容,而不是做為個別的 InkCanvas 層。

InkUnprocessedInput

提供來自 InkCanvas 控制件之筆跡數據的自定義處理屬性和事件。 InkPresenter 不會處理數據。

使用 InkInputProcessingConfiguration 來識別要傳遞為 UnprocessedInput 的數據。

PenAndInkSettings

在啟用 HandwritingView 時,提供使用者設定的存取權,以在啟用 HandwritingView 時,將筆跡轉換成文字輸入) (。

介面

IInkPointFactory

定義產生 InkStroke 建構中使用的 InkPoint 物件的型別實作。

IInkPresenterRulerFactory

定義產生 InkPresenterRuler 物件建構 InkPresenter 之型別的實作。

IInkPresenterStencil

表示可視化樣板,顯示為 InkCanvas 上的半透明重疊。

樣板會轉換筆墨筆劃的呈現方式:

  • 如果畫筆筆尖位於距離閾值內 (線) ,則會將筆墨筆劃貼齊樣板邊緣。
  • 它會做為遮罩,並防止在樣板遮蔽的區域內繪製筆墨筆劃。

樣板可以透過程序設計方式和使用者操作。 它也會使用 InkCanvas 來調整和轉譯。

IInkRecognizerContainer

代表一或多個 InkRecognizer 物件。

IInkStrokeContainer

代表 InkPresenter 所呈現之 InkStroke 物件的集合管理員。

對筆劃容器中任何筆墨筆劃所做的修改會立即轉譯為與 InkPresenter 相關聯的繪圖介面。

列舉

HandwritingLineHeight

指定在) 啟用 HandwritingView 時,在文字控件中使用筆跡進行文字輸入時可用的手寫空間 (。

InkDrawingAttributesKind

指定與 InkStroke 相關聯的 InkDrawingAttributes 類型。

InkHighContrastAdjustment

指定當系統處於高對比度模式時, InkPresenter 物件如何處理來自相關聯 InkCanvas 控件的輸入 (標準和修改) 。

InkInputProcessingMode

指定 InkPresenter 物件如何從其相關聯的 InkCanvas 控件解譯輸入。

根據預設,輸入會以標準筆跡或清除筆劃的形式處理,也可以當做 UnprocessedInput 傳遞至您的應用程式以進行自定義處理。

InkInputRightDragAction

指定 InkPresenter 物件如何處理手寫筆筒按鈕、手寫筆橡皮擦提示、滑鼠右鍵或類似的次要輸入。

根據預設,此次要輸入會處理為主要輸入,並轉譯為 InkStroke (請參閱備註) 。

InkManipulationMode

指定筆跡輸入的模式。

InkPersistenceFormat

指定儲存筆跡輸入的格式。

InkPresenterPredefinedConfiguration

指定一或多個聯繫人點的筆跡行為。 與 SetPredefinedConfiguration 搭配使用。

InkPresenterStencilKind

指定可在 InkCanvas 上顯示的樣板類型。

InkRecognitionTarget

指出您想要包含在手寫辨識中的筆劃。

PenHandedness

識別慣用的手寫手,如設定 - 裝置 ->> 手寫筆 & Windows Ink -> 選擇您撰寫的手寫筆

PenTipShape

識別 PenTip 的形狀。

另請參閱