InkCollectorNewInAirPacketsEventArgs.PacketData-Eigenschaft

Artikel
11/26/2008

Ruft ein Array vom Typ Int32 ab, das die ausgewählten Daten für das Paket enthält.

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

Syntax

'Declaration
Public ReadOnly Property PacketData As Integer()
'Usage
Dim instance As InkCollectorNewInAirPacketsEventArgs
Dim value As Integer()

value = instance.PacketData

public int[] PacketData { get; }

public:
property array<int>^ PacketData {
    array<int>^ get ();
}

/** @property */
public int[] get_PacketData()

public function get PacketData () : int[]

Eigenschaftenwert

Typ: array<System.Int32[]
Ein Array, das die ausgewählten Daten für das Paket enthält.

Hinweise

Verwenden Sie die DesiredPacketDescription-Eigenschaft des InkCollector-Objekts, um festzulegen, welche Eigenschaften in diesem Array enthalten sind. Das von der PacketData-Eigenschaft zurückgegebene Array enthält die Daten für diese Eigenschaften.

Hinweis

Zwar können Sie die Paketdaten ändern, jedoch werden diese Änderungen nicht beibehalten oder verwendet.

Eine vollständige Liste aller möglichen Eigenschaften, für die Daten in die PacketData-Eigenschaft aufgenommen werden können, finden Sie unter der DesiredPacketDescription-Eigenschaft des InkCollector-Objekts.

Beispiele

In diesem Beispiel ruft eine InkCollectorNewInAirPacketsEventHandler-Instanz den X-Wert und den Y-Wert des letzten über das InkCollectorNewInAirPacketsEventArgs-Objekt übergebenen Pakets ab. Der X-Wert und der Y-Wert befinden sich immer an den ersten zwei Positionen der Paketdaten.

Private Sub mInkObject_NewInAirPackets2(ByVal sender As Object, ByVal e As InkCollectorNewInAirPacketsEventArgs)
    Dim DescriptorsPerPacket As Integer = 0
    ' determine how many descriptors there are per packet
    ' you could also obtain this value using:
    '   e.PacketData.Length / e.PacketCount
    ' but if you need to know which particular properties
    ' are supported (beyond X and Y which are always placed first)
    ' you will need to query e.Cursor.Tablet.IsPacketPropertySupported()
    For Each G As Guid In mInkObject.DesiredPacketDescription
        If (e.Cursor.Tablet.IsPacketPropertySupported(G)) Then
            DescriptorsPerPacket += 1
        End If
    Next

    Dim LastX As Integer = e.PacketData(DescriptorsPerPacket * (e.PacketCount - 1))
    Dim LastY As Integer = e.PacketData((DescriptorsPerPacket * (e.PacketCount - 1)) + 1)
End Sub

private void mInkObject_NewInAirPackets2(object sender, InkCollectorNewInAirPacketsEventArgs e)
{
    int DescriptorsPerPacket = 0;
    // determine how many descriptors there are per packet
    // you could also obtain this value using:
    //   e.PacketData.Length / e.PacketCount
    // but if you need to know which particular properties
    // are supported (beyond X and Y which are always placed first)
    // you will need to query e.Cursor.Tablet.IsPacketPropertySupported()

    foreach (Guid G in mInkObject.DesiredPacketDescription)
    {
        if (e.Cursor.Tablet.IsPacketPropertySupported(G))
        {
            DescriptorsPerPacket++;
        }
    }

    int LastX = e.PacketData[DescriptorsPerPacket * (e.PacketCount - 1)];
    int LastY = e.PacketData[(DescriptorsPerPacket * (e.PacketCount - 1)) + 1];

}

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.