Stroke.GetPacketValuesByProperty-Methode (Guid)

Artikel
11/26/2008

Gibt die Daten für eine angegebene Paketeigenschaft für alle Pakete im Stroke-Objekt zurück.

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

Syntax

'Declaration
Public Function GetPacketValuesByProperty ( _
    id As Guid _
) As Integer()
'Usage
Dim instance As Stroke
Dim id As Guid
Dim returnValue As Integer()

returnValue = instance.GetPacketValuesByProperty(id)

public int[] GetPacketValuesByProperty(
    Guid id
)

public:
array<int>^ GetPacketValuesByProperty(
    Guid id
)

public int[] GetPacketValuesByProperty(
    Guid id
)

public function GetPacketValuesByProperty(
    id : Guid
) : int[]

Parameter

id
Typ: System.Guid
Der GUID-Bezeichner des PacketProperty-Objekts, mit dem die abzurufenden Paketdaten ausgewählt werden.

Rückgabewert

Typ: array<System.Int32[]
Gibt ein Array von 32-Bit-Ganzzahlen mit Vorzeichen zurück, das den Wert des angeforderten PacketProperty-Objekts für jeden vom Stroke-Objekt angeforderten Punkt angibt.

Hinweise

Eine bestimmte Paketeigenschaft ist in einem bestimmten Stroke-Objekt möglicherweise nicht verfügbar. Ein Tablet PC kann mehrere Tabletts für die Benutzereingabe aufweisen. Die Tablets-Auflistung enthält eine Liste mit allen an den Tablet PC angeschlossenen Tabletts. Verwenden Sie die IsPacketPropertySupported-Methode, um zu bestimmen, ob eine bestimmte Paketeigenschaft von einem spezifischen Tablet-Objekt oder von allen verfügbaren Tabletts unterstützt wird. Verwenden Sie außerdem die Eigenschaften InkCollector.DesiredPacketDescription, InkOverlay.DesiredPacketDescription oder InkPicture.DesiredPacketDescription, um zu steuern, welche Paketeigenschaften in neuen Strichen gesammelt werden.

Beispiele

In diesem Beispiel wird jedes Stroke-Objekt eines InkOverlay-Objekts so geändert, dass das NormalPressure-Paket im Verlauf der Punkte des Strichs stets zunimmt oder konstant bleibt.

Mithilfe der GetPacketValuesByProperty-Methode werden die NormalPressure-Paketwerte für die zweite Hälfte des Stroke-Objekts abgerufen und in aufsteigender Reihenfolge sortiert. Die sortierten Werte werden dann mit der SetPacketValuesByProperty-Methode erneut dem Strich zugewiesen.

Try
    For Each S As Stroke In mInkOverlay.Selection
        ' get the NormalPressure values
        Dim npValues() As Integer = S.GetPacketValuesByProperty(PacketProperty.NormalPressure)
        ' sort them
        Array.Sort(npValues)
        ' set the NormalPressure values
        S.SetPacketValuesByProperty(PacketProperty.NormalPressure, 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 NormalPressure values
        int[] npValues = S.GetPacketValuesByProperty(PacketProperty.NormalPressure);
        // sort them
        Array.Sort(npValues);
        // set the NormalPressure values
        S.SetPacketValuesByProperty(PacketProperty.NormalPressure, 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.