Recognizer.PreferredPacketDescription プロパティ

2008-10-28

認識エンジンの優先されるパケットプロパティを表す Guid 型の配列を取得します。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
Public ReadOnly Property PreferredPacketDescription As Guid()
'使用
Dim instance As Recognizer
Dim value As Guid()

value = instance.PreferredPacketDescription

public Guid[] PreferredPacketDescription { get; }

public:
property array<Guid>^ PreferredPacketDescription {
    array<Guid>^ get ();
}

/** @property */
public Guid[] get_PreferredPacketDescription()

public function get PreferredPacketDescription () : Guid[]

プロパティ値

型 : array<System.Guid[]
認識エンジンの優先されるパケットプロパティを表します。

解説

PreferredPacketDescription プロパティは、パケットの内容を表し、パケットに含まれているデータへのアクセスを許可しません。

PreferredPacketDescription プロパティは、認識エンジンが認識の実行に使用するパケットプロパティを一覧表示します。すべての Microsoft® 認識エンジンに関して、PreferredPacketDescription プロパティは Stroke オブジェクト内の座標を示すデータ (x,y) を参照します。このデータは、PacketProperty オブジェクトの X フィールドおよび Y フィールドにより表されます。パケットには、このポイントデータに加えて、ストロークを生成するペンの圧力やペンの角度など、そのストロークに関連する他のデータも含まれます。Microsoft 認識エンジンは、圧力、傾き、および他のパケットプロパティを無視します。

例

この C# の例では、Recognizer オブジェクト theRecognizer に、優先されるパケットの説明の 1 つとして X が含まれる場合は true を返す関数を作成します。

using Microsoft.Ink;
// . . .
public bool PrefersX(Recognizer theRecognizer)
{
    Guid[] theDescription =
        theRecognizer.PreferredPacketDescription;
    for (int i = 0; i < theDescription.Length; i++)
    {
        if (theDescription[i] == PacketProperty.X)
            return true;
    }
    return false;
}

この Microsoft Visual Basic® .NET の例では、Recognizer オブジェクト theRecognizer に、優先されるパケットの説明の 1 つとして X が含まれる場合は true を返す関数が作成されます。

Imports Microsoft.Ink
' . . .
Public Function PrefersX(ByVal theRecognizer As Recognizer) As Boolean
    Dim theDescription () As Guid
    TheDescription = theRecognizer.PreferredPacketDescription
    Dim k As Integer
    For k = 0 To theDescription.Length
        If theDescription(k).ToString() = PacketProperty.X.ToString() Then
            Return True
        End If
    Next
    Return False
End Function