Recognizer.PreferredPacketDescription Property
Recognizer.PreferredPacketDescription Property |
Gets an array of type Guid that represents the preferred packet properties for the recognizer.
Definition
Visual Basic .NET Public ReadOnly Property PreferredPacketDescription As Guid() C# public Guid[] PreferredPacketDescription { get; } Managed C++ public: __property Guid* get_PreferredPacketDescription();
Property Value
System.Guid[]. Represents the preferred packet properties for the recognizer.
This property is read-only. This property has no default value.
Remarks
The PreferredPacketDescription property describes the contents of a packet and does not allow access to the data that the packet contains.
The PreferredPacketDescription property lists the packet properties that the recognizer uses to complete recognition. For all of the Microsoft® recognizers, the PreferredPacketDescription property refers to the data describing (x,y) coordinates within a Stroke object. This data is represented by the X and Y fields of the PacketProperty object. A packet contains this point data as well as other data that is related to that stroke, such as the pressure of the pen that made the stroke, the angle of the pen, and so on. The Microsoft recognizers ignore pressure, tilt, and other packet properties.
Examples
[C#]
This C# example creates a function that returns true if the Recognizer object, theRecognizer, has X as one of its preferred packet descriptions.
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; }
[Visual Basic .NET]
This Microsoft Visual Basic® .NET example creates a function that returns true if the Recognizer object, theRecognizer, has X as one of its preferred packet descriptions.
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
See Also