StylusPoint StylusPoint StylusPoint StylusPoint Struct

Определение

Представляет одну точку данных, полученную от диджитайзера или пера.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)
Наследование
StylusPointStylusPointStylusPointStylusPoint
Реализации

Примеры

В следующем примере возвращаются имена и значения свойств для каждого StylusPoint в StylusPointCollection.The following example gets property names and values for each StylusPoint in a StylusPointCollection. В этом примере предполагается, что имеется TextBlock вызывается 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 'WriteStylusPointValues

// 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

Комментарии

Объект StylusPoint собирает данные, когда пользователь вводит данные рукописного ввода с помощью дигитайзера.A StylusPoint collects data when a user inputs ink using the digitizer. Так как информация о дигитайзером, отличается в зависимости от производителя, свойства, используемые в StylusPoint могут различаться.Because the information that a digitizer reports differs depending on the manufacturer, the properties within a StylusPoint can vary. Чтобы определить, является ли свойство в StylusPoint, вызовите HasProperty метод.To determine whether a property is in the StylusPoint, call the HasProperty method. Description Свойство содержит StylusPointDescription , указывающий, какие свойства находятся в StylusPoint.The Description property contains a StylusPointDescription that specifies which properties are in the StylusPoint. Все StylusPoint объекты содержат свойства, определяющие (x, y) координаты, а также давление.All StylusPoint objects contain properties that specify the (x, y) coordinates, as well as the pressure.

Конструкторы

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

Инициализирует новый экземпляр класса StylusPoint, используя указанные координаты (X, Y).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)

Инициализирует новый экземпляр класса StylusPoint, используя заданные координаты (x, y) и давление.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[])

Инициализирует новый экземпляр класса StylusPoint, используя указанные координаты (X, Y), pressureFactor и дополнительные параметры, заданные в StylusPointDescription.Initializes a new instance of the StylusPoint class using specified (x, y) coordinates, a pressureFactor, and additional parameters specified in the StylusPointDescription.

Поля

MaxXY MaxXY MaxXY MaxXY

Задает максимальное допустимое значение для пары координат (x, y).Specifies the largest valid value for a pair of (x, y) coordinates.

MinXY MinXY MinXY MinXY

Задает минимальное допустимое значение для пары координат (x, y).Specifies the smallest valid value for a pair of (x, y) coordinates.

Свойства

Description Description Description Description

Получает или задает объект StylusPointDescription определяющий свойства, хранящиеся в StylusPoint.Gets or sets the StylusPointDescription that specifies the properties stored in the StylusPoint.

PressureFactor PressureFactor PressureFactor PressureFactor

Получает или задает значение от 0 до 1, отражающее силу давления пера на поверхность диджитайзера, когда создается StylusPoint.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

Получает или задает значение координаты x объекта StylusPoint.Gets or sets the value for the x-coordinate of the StylusPoint.

Y Y Y Y

Получает или задает y-координату объекта StylusPoint.Gets or sets the y-coordinate of the StylusPoint.

Методы

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

Возвращает значение, указывающее, равен ли заданный объект объекту StylusPoint.Returns a value indicating whether the specified object is equal to the StylusPoint.

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

Возвращает логическое значение, показывающее, равен ли заданный объект StylusPoint текущему объекту StylusPoint.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)

Возвращает логическое значение, указывающее, равны ли два заданных объекта StylusPoint.Returns a Boolean value that indicates whether the two specified StylusPoint objects are equal.

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

Возвращает хэш-код данного экземпляра.Returns the hash code for this instance.

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

Возвращает значение заданного свойства.Returns the value of the specified property.

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

Возвращает значение, указывающее, содержит ли текущий StylusPoint заданное свойство.Returns whether the current StylusPoint contains the specified property.

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

Присваивает заданному свойству заданное значение.Sets the specified property to the specified value.

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

Преобразует StylusPoint в Point.Converts a StylusPoint to a Point.

Операторы

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

Сравнивает два заданных объекта StylusPoint, и определяет, являются ли они равными.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)

Приводит указанный объект StylusPoint к типу Point.Casts the specified StylusPoint to a Point.

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

Возвращает логическое значение, указывающее, являются ли два заданных объекта StylusPoint неравными.Returns a Boolean value which indicates whether the specified StylusPoint objects are unequal.

Применяется к