Stroke.GetPacketDescriptionPropertyMetrics-Methode

Artikel
11/26/2008

Gibt die Metrik für einen gegebenen Paketbeschreibungstyp zurück.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Function GetPacketDescriptionPropertyMetrics ( _
    id As Guid _
) As TabletPropertyMetrics
'Usage
Dim instance As Stroke
Dim id As Guid
Dim returnValue As TabletPropertyMetrics

returnValue = instance.GetPacketDescriptionPropertyMetrics(id)

public TabletPropertyMetrics GetPacketDescriptionPropertyMetrics(
    Guid id
)

public:
TabletPropertyMetrics GetPacketDescriptionPropertyMetrics(
    Guid id
)

public TabletPropertyMetrics GetPacketDescriptionPropertyMetrics(
    Guid id
)

public function GetPacketDescriptionPropertyMetrics(
    id : Guid
) : TabletPropertyMetrics

Parameter

id
Typ: System.Guid
Die Guid des PacketProperty-Objekts, das die Eigenschaft identifiziert, für die die Metrik abgerufen werden soll.

Rückgabewert

Typ: Microsoft.Ink.TabletPropertyMetrics
Gibt die Metrik für einen gegebenen Paketbeschreibungstyp zurück.

Beispiele

In diesem Beispiel wird jedes Stroke-Objekt eines InkOverlay-Objekts so geändert, dass jeder Punkt der zweiten Hälfte des Strichs den maximal zulässigen NormalPressure-Paketwert enthält.

Mithilfe der GetPacketValuesByProperty-Methode werden die NormalPressure-Paketwerte für die zweite Hälfte des Stroke-Objekts abgerufen. Anschließend werden die Werte auf den zulässigen Höchstwert festgelegt (der über die GetPacketDescriptionPropertyMetrics-Methode abgerufen wurde) und mit der SetPacketValuesByProperty-Methode erneut auf den Strich angewendet.

Try
    For Each S As Stroke In mInkOverlay.Selection
        ' get the PacketProperty.NormalPressure metrics for the stroke
        Dim metrics As TabletPropertyMetrics = S.GetPacketDescriptionPropertyMetrics(PacketProperty.NormalPressure)
        ' get the starting point
        Dim startPt As Integer = S.PacketCount / 2
        ' get the NormalPressure values starting at startPt
        Dim npValues() As Integer = S.GetPacketValuesByProperty(PacketProperty.NormalPressure, startPt)
        ' set the NormalPressure values to max
        For k As Integer = 0 To npValues.Length - 1
            npValues(k) = metrics.Maximum
        Next
        ' set the NormalPressure values starting at startPt
        S.SetPacketValuesByProperty(PacketProperty.NormalPressure, startPt, npValues)
    Next

Catch ex As ArgumentException
    ' This exception will be raised if PacketProperty.NormalPressure is not supported
    ' This will be the case if creating strokes with a mouse
End Try

try
{
    foreach (Stroke S in mInkOverlay.Selection)
    {
        // get the PacketProperty.NormalPressure metrics for the stroke
        TabletPropertyMetrics metrics = S.GetPacketDescriptionPropertyMetrics(PacketProperty.NormalPressure);
        // get the starting point
        int startPt = S.PacketCount / 2;
        // get the NormalPressure values starting at startPt
        int[] npValues = S.GetPacketValuesByProperty(PacketProperty.NormalPressure, startPt);
        // set the NormalPressure values to max
        for (int k = 0; k < npValues.Length; k++)
        {
            npValues[k] = metrics.Maximum;
        }
        // set the NormalPressure values starting at startPt
        S.SetPacketValuesByProperty(PacketProperty.NormalPressure, startPt, npValues);
    }
}
catch (ArgumentException)
{
    // This exception will be raised if PacketProperty.NormalPressure is not supported
    // This will be the case if creating strokes with a mouse
}

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.