StylusPoint Structure

Définition

Représente un point de données unique recueilli à partir du digitaliseur et du stylet.Represents a single data point collected from the digitizer and stylus.

public value class StylusPoint : IEquatable<System::Windows::Input::StylusPoint>
public struct StylusPoint : IEquatable<System.Windows.Input.StylusPoint>
type StylusPoint = struct
Public Structure StylusPoint
Implements IEquatable(Of StylusPoint)
Héritage
StylusPoint
Implémente

Exemples

L’exemple suivant obtient les noms et les valeurs des propriétés de chaque StylusPoint dans une StylusPointCollection.The following example gets property names and values for each StylusPoint in a StylusPointCollection. Cet exemple suppose qu’il existe une TextBlock appelée packetOutput.This example assumes that there is a TextBlock called packetOutput.

private void WriteStylusPointValues(StylusPointCollection points)
{
    StylusPointDescription pointsDescription = points.Description;

    ReadOnlyCollection<StylusPointPropertyInfo> properties = 
        pointsDescription.GetStylusPointProperties();
    
    // Write the name and value of each property in
    // every stylus point.
    StringWriter packetWriter = new StringWriter();
    packetWriter.WriteLine("{0} stylus points", points.Count.ToString());
    foreach (StylusPoint stylusPoint in points)
    {
        packetWriter.WriteLine("Stylus Point info");
        packetWriter.WriteLine("X: {0}", stylusPoint.X.ToString());
        packetWriter.WriteLine("Y: {0}", stylusPoint.Y.ToString());
        packetWriter.WriteLine("Pressure: {0}", stylusPoint.PressureFactor.ToString());

        // Get the property name and value for each StylusPoint.
        // Note that this loop reports the X, Y, and pressure values differantly than 
        // getting their values above.
        for (int i = 0; i < pointsDescription.PropertyCount; ++i)
        {
            StylusPointProperty currentProperty = properties[i];

            // GetStylusPointPropertyName is defined below and returns the
            // name of the property.
            packetWriter.Write("{0}: ", GetStylusPointPropertyName(currentProperty));
            packetWriter.WriteLine(stylusPoint.GetPropertyValue(currentProperty).ToString());
        }
        packetWriter.WriteLine();

    }

    packetOutput.Text = packetWriter.ToString();
}
Private Sub WriteStylusPointValues(ByVal points As StylusPointCollection) 
    Dim pointsDescription As StylusPointDescription = points.Description
    
    Dim properties As ReadOnlyCollection(Of StylusPointPropertyInfo) = _
                            pointsDescription.GetStylusPointProperties()
    
    ' Write the name and value of each property in
    ' every stylus point.
    Dim packetWriter As New StringWriter()

    packetWriter.WriteLine("{0} stylus points", points.Count.ToString())

    For Each stylusPoint As StylusPoint In points

        packetWriter.WriteLine("Stylus Point info")
        packetWriter.WriteLine("X: {0}", stylusPoint.X.ToString())
        packetWriter.WriteLine("Y: {0}", stylusPoint.Y.ToString())
        packetWriter.WriteLine("Pressure: {0}", stylusPoint.PressureFactor.ToString())

        ' Get the property name and value for each StylusPoint.
        ' Note that this loop reports the X, Y, and pressure values differantly than 
        ' getting their values above.
        For i As Integer = 0 To pointsDescription.PropertyCount - 1

            Dim currentProperty As StylusPointProperty = properties(i)

            ' GetStylusPointPropertyName is defined below and returns the
            ' name of the property.
            packetWriter.Write("{0}: ", GetStylusPointPropertyName(currentProperty))
            packetWriter.WriteLine(stylusPoint.GetPropertyValue(currentProperty).ToString())
        Next i

        packetWriter.WriteLine()

    Next stylusPoint

    packetOutput.Text = packetWriter.ToString()

End Sub

// Use reflection to get the name of currentProperty.
private string GetStylusPointPropertyName(StylusPointProperty currentProperty)
{
    Guid guid = currentProperty.Id;

    // Iterate through the StylusPointProperties to find the StylusPointProperty
    // that matches currentProperty, then return the name.
    foreach (FieldInfo theFieldInfo
        in typeof(StylusPointProperties).GetFields())
    {
        StylusPointProperty property = (StylusPointProperty) theFieldInfo.GetValue(currentProperty);
        if (property.Id == guid)
        {
            return theFieldInfo.Name;
        }
    }
    return "Not found";
}
' Use reflection to get the name of currentProperty.
Private Function GetStylusPointPropertyName(ByVal currentProperty As StylusPointProperty) As String 
    Dim guid As Guid = currentProperty.Id
    
    ' Iterate through the StylusPointProperties to find the StylusPointProperty
    ' that matches currentProperty, then return the name.
    Dim theFieldInfo As FieldInfo

    For Each theFieldInfo In GetType(StylusPointProperties).GetFields()

        Dim pointProperty As StylusPointProperty = _
            CType(theFieldInfo.GetValue(currentProperty), StylusPointProperty)

        If pointProperty.Id = guid Then
            Return theFieldInfo.Name
        End If

    Next theFieldInfo

    Return "Not found"

End Function 'GetStylusPointPropertyName

Remarques

Une StylusPoint collecte des données lorsqu’un utilisateur entre de l’encre à l’aide du digitaliseur.A StylusPoint collects data when a user inputs ink using the digitizer. Étant donné que les informations qu’un digitaliseur signalent diffèrent en fonction du fabricant, les propriétés d’un StylusPoint peuvent varier.Because the information that a digitizer reports differs depending on the manufacturer, the properties within a StylusPoint can vary. Pour déterminer si une propriété se trouve dans le StylusPoint, appelez la méthode HasProperty.To determine whether a property is in the StylusPoint, call the HasProperty method. La propriété Description contient une StylusPointDescription qui spécifie les propriétés qui se trouvent dans le StylusPoint.The Description property contains a StylusPointDescription that specifies which properties are in the StylusPoint. Tous les objets StylusPoint contiennent des propriétés qui spécifient les coordonnées (x, y), ainsi que la pression.All StylusPoint objects contain properties that specify the (x, y) coordinates, as well as the pressure.

Constructeurs

StylusPoint(Double, Double)

Initialise une nouvelle instance de la classe StylusPoint à l’aide des coordonnées (x, y) spécifiées.Initializes a new instance of the StylusPoint class using specified (x, y) coordinates.

StylusPoint(Double, Double, Single)

Initialise une nouvelle instance de la classe StylusPoint à l'aide des coordonnées (x, y) spécifiées et de la pression.Initializes a new instance of the StylusPoint class using specified (x, y) coordinates and pressure.

StylusPoint(Double, Double, Single, StylusPointDescription, Int32[])

Initialise une nouvelle instance de la classe StylusPoint à l’aide des coordonnées (x, y) spécifiées, un pressureFactor et des paramètres supplémentaires spécifiés dans la StylusPointDescription.Initializes a new instance of the StylusPoint class using specified (x, y) coordinates, a pressureFactor, and additional parameters specified in the StylusPointDescription.

Champs

MaxXY

Spécifie la plus grande valeur valide pour une paire de coordonnées (x, y).Specifies the largest valid value for a pair of (x, y) coordinates.

MinXY

Spécifie la plus petite valeur valide pour une paire de coordonnées (x, y).Specifies the smallest valid value for a pair of (x, y) coordinates.

Propriétés

Description

Obtient ou définit le StylusPointDescription qui spécifie les propriétés stockées dans le StylusPoint.Gets or sets the StylusPointDescription that specifies the properties stored in the StylusPoint.

PressureFactor

Obtient ou définit une valeur entre 0 et 1 qui reflète la quantité de pression que le stylet applique à la surface du digitaliseur lorsque le StylusPoint est créé.Gets or sets a value between 0 and 1 that reflects the amount of pressure the stylus applies to the digitizer's surface when the StylusPoint is created.

X

Obtient ou définit la valeur de la coordonnée x du StylusPoint.Gets or sets the value for the x-coordinate of the StylusPoint.

Y

Obtient ou définit la coordonnée y du StylusPoint.Gets or sets the y-coordinate of the StylusPoint.

Méthodes

Equals(Object)

Retourne une valeur indiquant si l'objet spécifié est égal au StylusPoint.Returns a value indicating whether the specified object is equal to the StylusPoint.

Equals(StylusPoint)

Retourne une valeur booléenne qui indique si le StylusPoint spécifié est égal au StylusPointactuel.Returns a Boolean value that indicates whether the specified StylusPoint is equal to the current StylusPoint.

Equals(StylusPoint, StylusPoint)

Retourne une valeur booléenne qui indique si les deux objets StylusPoint spécifiés sont égaux.Returns a Boolean value that indicates whether the two specified StylusPoint objects are equal.

GetHashCode()

Retourne le code de hachage de cette instance.Returns the hash code for this instance.

GetPropertyValue(StylusPointProperty)

Retourne la valeur de la propriété spécifiée.Returns the value of the specified property.

HasProperty(StylusPointProperty)

Retourne si le StylusPoint actuel contient la propriété spécifiée.Returns whether the current StylusPoint contains the specified property.

SetPropertyValue(StylusPointProperty, Int32)

Définit la propriété spécifiée sur la valeur indiquée.Sets the specified property to the specified value.

ToPoint()

Convertit une StylusPoint en une Point.Converts a StylusPoint to a Point.

Opérateurs

Equality(StylusPoint, StylusPoint)

Compare deux objets StylusPoint spécifiés et détermine s'ils sont égaux.Compares two specified StylusPoint objects and determines whether they are equal.

Explicit(StylusPoint to Point)

Caste le StylusPoint spécifié en Point.Casts the specified StylusPoint to a Point.

Inequality(StylusPoint, StylusPoint)

Retourne une valeur booléenne qui indique si les objets StylusPoint spécifiés sont inégaux.Returns a Boolean value which indicates whether the specified StylusPoint objects are unequal.

S’applique à