StylusPoint StylusPoint StylusPoint StylusPoint Struct

Definition

Stellt einen einzelnen Datenpunkt dar, der vom Digitizer und vom Tablettstift erfasst wurde.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)
Vererbung
StylusPointStylusPointStylusPointStylusPoint
Implementiert

Beispiele

Im folgenden Beispiel werden Eigenschaftsnamen und-Werte für jede StylusPoint in einer StylusPointCollection abgerufen.The following example gets property names and values for each StylusPoint in a StylusPointCollection. In diesem Beispiel wird davon ausgegangen, dass ein TextBlock mit dem Namen packetOutput vorhanden ist.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

Hinweise

Ein StylusPoint sammelt Daten, wenn ein Benutzer mithilfe des Digitalisierers Eingaben eingibt.A StylusPoint collects data when a user inputs ink using the digitizer. Da sich die Informationen, die ein Digitalisierer meldet, abhängig vom Hersteller unterscheiden, können die Eigenschaften innerhalb einer StylusPoint variieren.Because the information that a digitizer reports differs depending on the manufacturer, the properties within a StylusPoint can vary. Um zu ermitteln, ob eine Eigenschaft im StylusPoint ist, müssen Sie die HasProperty-Methode aufzurufen.To determine whether a property is in the StylusPoint, call the HasProperty method. Die Description-Eigenschaft enthält einen StylusPointDescription, der angibt, welche Eigenschaften in der StylusPoint enthalten sind.The Description property contains a StylusPointDescription that specifies which properties are in the StylusPoint. Alle StylusPoint-Objekte enthalten Eigenschaften, mit denen die (x, y)-Koordinaten sowie der Druck angegeben werden.All StylusPoint objects contain properties that specify the (x, y) coordinates, as well as the pressure.

Konstruktoren

StylusPoint(Double, Double) StylusPoint(Double, Double) StylusPoint(Double, Double) StylusPoint(Double, Double)

Initialisiert eine neue Instanz der StylusPoint-Klasse unter Verwendung der angegebenen (X, Y)-Koordinaten.Initializes a new instance of the StylusPoint class using specified (x, y) coordinates.

StylusPoint(Double, Double, Single) StylusPoint(Double, Double, Single) StylusPoint(Double, Double, Single) StylusPoint(Double, Double, Single)

Initialisiert eine neue Instanz der StylusPoint-Klasse mit den angegebenen (x, y)-Koordinaten und dem Druck.Initializes a new instance of the StylusPoint class using specified (x, y) coordinates and pressure.

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

Initialisiert eine neue Instanz der StylusPoint-Klasse mit den angegebenen (X, Y)-Koordinaten, einem pressureFactor und zusätzlichen, in der StylusPointDescription angegebenen Parametern.Initializes a new instance of the StylusPoint class using specified (x, y) coordinates, a pressureFactor, and additional parameters specified in the StylusPointDescription.

Felder

MaxXY MaxXY MaxXY MaxXY

Gibt den größten gültigen Wert für ein (x, y)-Koordinatenpaar an.Specifies the largest valid value for a pair of (x, y) coordinates.

MinXY MinXY MinXY MinXY

Gibt den kleinsten gültigen Wert für ein (x, y)-Koordinatenpaar an.Specifies the smallest valid value for a pair of (x, y) coordinates.

Eigenschaften

Description Description Description Description

Ruft die StylusPointDescription ab, die die im StylusPoint gespeicherten Eigenschaften angibt, oder legt diese fest.Gets or sets the StylusPointDescription that specifies the properties stored in the StylusPoint.

PressureFactor PressureFactor PressureFactor PressureFactor

Ruft einen Wert zwischen 0 und 1 ab, der den Druck widerspiegelt, den der Tablettstift bei Erstellung des StylusPoint auf die Oberfläche des Digitizers anwendet, oder legt diesen Wert fest.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 X X X

Ruft den Wert der x-Koordinate des StylusPoint ab oder legt diesen fest.Gets or sets the value for the x-coordinate of the StylusPoint.

Y Y Y Y

Ruft die y-Koordinate des StylusPoint ab oder legt diese fest.Gets or sets the y-coordinate of the StylusPoint.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Gibt einen Wert zurück, der angibt, ob das angegebene Objekt gleich dem StylusPoint ist.Returns a value indicating whether the specified object is equal to the StylusPoint.

Equals(StylusPoint) Equals(StylusPoint) Equals(StylusPoint) Equals(StylusPoint)

Gibt einen booleschen Wert zurück, der angibt, ob der angegebene StylusPoint gleich dem aktuellen StylusPoint ist.Returns a Boolean value that indicates whether the specified StylusPoint is equal to the current StylusPoint.

Equals(StylusPoint, StylusPoint) Equals(StylusPoint, StylusPoint) Equals(StylusPoint, StylusPoint) Equals(StylusPoint, StylusPoint)

Gibt einen booleschen Wert zurück, der angibt, ob die zwei angegebenen StylusPoint-Objekte gleich sind.Returns a Boolean value that indicates whether the two specified StylusPoint objects are equal.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Gibt den Hashcode für diese Instanz zurück.Returns the hash code for this instance.

GetPropertyValue(StylusPointProperty) GetPropertyValue(StylusPointProperty) GetPropertyValue(StylusPointProperty) GetPropertyValue(StylusPointProperty)

Gibt den Wert der angegebenen Eigenschaft zurück.Returns the value of the specified property.

HasProperty(StylusPointProperty) HasProperty(StylusPointProperty) HasProperty(StylusPointProperty) HasProperty(StylusPointProperty)

Gibt zurück, ob der aktuelle StylusPoint die angegebene Eigenschaft enthält.Returns whether the current StylusPoint contains the specified property.

SetPropertyValue(StylusPointProperty, Int32) SetPropertyValue(StylusPointProperty, Int32) SetPropertyValue(StylusPointProperty, Int32) SetPropertyValue(StylusPointProperty, Int32)

Legt die angegebene Eigenschaft auf den angegebenen Wert fest.Sets the specified property to the specified value.

ToPoint() ToPoint() ToPoint() ToPoint()

Konvertiert ein StylusPoint -Element in ein Point-Element.Converts a StylusPoint to a Point.

Operatoren

Equality(StylusPoint, StylusPoint) Equality(StylusPoint, StylusPoint) Equality(StylusPoint, StylusPoint) Equality(StylusPoint, StylusPoint)

Vergleicht zwei angegebene StylusPoint-Objekte und ermittelt, ob diese gleich sind.Compares two specified StylusPoint objects and determines whether they are equal.

Explicit(StylusPoint to Point) Explicit(StylusPoint to Point) Explicit(StylusPoint to Point) Explicit(StylusPoint to Point)

Wandelt den angegebenen StylusPoint in einen Point um.Casts the specified StylusPoint to a Point.

Inequality(StylusPoint, StylusPoint) Inequality(StylusPoint, StylusPoint) Inequality(StylusPoint, StylusPoint) Inequality(StylusPoint, StylusPoint)

Gibt einen booleschen Wert zurück, der angibt, ob die angegebenen StylusPoint-Objekte ungleich sind.Returns a Boolean value which indicates whether the specified StylusPoint objects are unequal.

Gilt für: