InkManager 類別

定義

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager。

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

public ref class InkManager sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class InkManager final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class InkManager final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class InkManager
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class InkManager
function InkManager()
Public NotInheritable Class InkManager
繼承
Object Platform::Object IInspectable InkManager
屬性
實作

Windows 需求

裝置系列
Windows 10 (已於 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

此範例示範如何建立 InkManager 物件。

var inkManager = new Windows.UI.Input.Inking.InkManager();

下列函式示範如何在 畫布 上選取屬於此 InkManager 筆劃集合一部分的所有筆墨筆劃 (inkManager) 。

function selectAll()
{
    inkManager.getStrokes().forEach(
        function (stroke) 
        {
            stroke.selected = 1;
        }
    );
}

備註

如果不需要辨識,請使用 InkStrokeContainer 物件,而不是 InkManager。 先前的辨識結果仍可透過 GetRecognitionResults取得。

如果只需要辨識,而不是儲存體,請使用 InkRecognizerContainer 而不是 InkManager。

注意

這個類別不是敏捷的,這表示您必須考慮其執行緒模型和封送處理行為。 如需詳細資訊,請參閱執行緒和封送處理 (C++/CX) 在多執行緒環境中使用 Windows 執行階段 物件 (.NET)

建構函式

InkManager()

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

建立用來管理InkStroke物件的新InkManager物件。

屬性

BoundingRect

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

取得InkManager所管理之 InkStroke集合的周框。

Mode

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

取得或設定筆跡輸入模式。

方法

AddStroke(InkStroke)

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

將一或多個 InkStroke 物件新增至 InkManager所管理的集合。

CanPasteFromClipboard()

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

識別剪貼簿上的內容是否可以新增至InkManager所管理的InkStroke集合。

注意

剪貼簿內容必須以筆跡序列化格式 (ISF) 。

CopySelectedToClipboard()

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

InkManager所管理的InkStroke集合中,將選取的InkStroke物件 (複製到 Ink Serialized Format) (ISF) 格式的剪貼簿。

DeleteSelected()

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

InkManager管理的InkStroke集合中刪除選取的InkStroke物件。

GetRecognitionResults()

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

擷取手寫辨識所傳回的字組集合。

GetRecognizers()

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

取得已安裝手寫辨識器的集合。

GetStrokes()

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

擷取 InkManager所管理之集合中的所有筆墨筆劃。

LoadAsync(IInputStream)

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

以非同步方式將所有 InkStroke 物件從指定的資料流程載入 InkStroke 集合,該集合是由 InkManager所管理。

筆跡資料會在 ISF) 中繼資料 (序列化為筆跡序列化格式,並內嵌到圖形交換格式 (GIF) 檔案中。

MoveSelected(Point)

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

移動選取的筆劃。 所有受影響的筆劃都會重新轉譯。

PasteFromClipboard(Point)

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

InkStroke內容從剪貼簿新增至InkManager管理的InkStroke集合,並轉譯新的筆劃。

ProcessPointerDown(PointerPoint)

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

在初始向下接觸點上處理接觸點的位置和功能相關資訊,例如壓力和傾斜。 您必須先呼叫這個方法,才能呼叫 ProcessPointerUpdate,然後呼叫 ProcessPointerUp。

重要

傳統型應用程式中不支援這個方法。

ProcessPointerUp(PointerPoint)

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

處理接觸點的位置和功能相關資訊,例如壓力和傾斜。 您必須在呼叫 ProcessPointerUpdate之後呼叫這個方法。

重要

傳統型應用程式中不支援這個方法。

ProcessPointerUpdate(PointerPoint)

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

處理指定指標的位置和狀態屬性,例如壓力和傾斜,從最後一個指標事件到目前指標事件,以及包含目前的指標事件。在 ProcessPointerDownProcessPointerUp之前呼叫這個方法。

重要

傳統型應用程式中不支援這個方法。

RecognizeAsync(InkRecognitionTarget)

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

在一或多個 InkStroke 物件上執行手寫辨識。

RecognizeAsync(InkStrokeContainer, InkRecognitionTarget)

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

在一或多個 InkStroke 物件上執行手寫辨識。

SaveAsync(IOutputStream)

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

以非同步方式將所有 InkStroke 物件儲存在 InkStroke 集合中,由 InkManager 管理至指定的資料流程。

筆跡資料會在 ISF) 中繼資料 (序列化為筆跡序列化格式,並內嵌到圖形交換格式 (GIF) 檔案中。

SelectWithLine(Point, Point)

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

選取與新筆劃交集的所有筆劃。

注意

集合中所有其他筆劃的 [選取 ] 旗標會重設。

SelectWithPolyLine(IIterable<Point>)

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

選取完全包含在聚合線內的所有筆劃。

注意

集合中所有其他筆劃的 [選取 ] 旗標會重設。

.

SetDefaultDrawingAttributes(InkDrawingAttributes)

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

設定所有新增至InkManager所管理InkStroke集合之新InkStroke物件的預設InkDrawingAttributes

SetDefaultDrawingAttributes 不會影響目前的筆劃或任何現有的筆劃。

SetDefaultRecognizer(InkRecognizer)

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

設定用於手寫辨 識的預設 InkRecognizer

UpdateRecognitionResults(IVectorView<InkRecognitionResult>)

注意

針對使用 Extensible Application Markup Language (XAML) 的通用 Windows 應用程式,我們建議使用 InkPresenterInkCanvas 控制項,而不是 InkManager

更新手寫辨識中可能文字相符專案的集合。

適用於

另請參閱