Windows.UI.Input.Inking 命名空間
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
提供 Windows Ink 應用程式的輸入、處理和管理支援。 這包括:
- 繪製筆墨筆劃。
- 擷取筆劃。
- 轉譯筆劃。
- 選取筆劃。
- 刪除筆劃。
- 儲存和載入筆劃。
- 透過手寫辨識將筆劃轉換成文字。
- 從剪貼簿複製和貼上筆劃。
- 點擊測試 (或筆劃目標) 。
類別
InkDrawingAttributes |
提供與 InkStroke 繪圖相關聯的屬性。 |
InkDrawingAttributesPencilProperties |
提供一組靜態 InkDrawingAttributes 屬性,以轉譯 InkCanvas 上的鉛筆筆劃。 呼叫 InkDrawingAttributes.CreateForPencil 並存取 InkDrawingAttributes.PencilProperties,以取得此類別的實例。 |
InkInputConfiguration |
管理 InkPresenter 物件可以處理哪些類型的次要輸入。 |
InkInputProcessingConfiguration |
管理 InkPresenter 對象處理輸入的方式。 |
InkManager |
注意 針對使用可延伸應用程式標記語言的通用 Windows 應用程式 (XAML) ,我們建議使用 InkPresenter 和 InkCanvas 控件,而不是 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) ,我們建議使用 InkPresenter 和 InkCanvas 控件,而不是 InkManager。 使用 CreateStrokeFromInkPoints 和 SetDefaultDrawingAttributes 以程式設計方式建置 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 物件,來自訂如何將筆墨筆劃以烘乾狀態轉譯到 SurfaceImageSource 或 VirtualSurfaceImageSource。 例如,筆墨筆劃會被點陣化並整合到應用程式內容,而不是做為個別的 InkCanvas 層。 |
InkUnprocessedInput |
提供來自 InkCanvas 控制件之筆跡數據的自定義處理屬性和事件。 InkPresenter 不會處理數據。 使用 InkInputProcessingConfiguration 來識別要傳遞為 UnprocessedInput 的數據。 |
PenAndInkSettings |
在啟用 HandwritingView 時,提供使用者設定的存取權,以在啟用 HandwritingView 時,將筆跡轉換成文字輸入) (。 |
介面
IInkPointFactory | |
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 的形狀。 |