IInkStrokeDisp::GetPacketData-Methode (msinkaut.h)

Ruft die Paketdaten für einen Paketbereich innerhalb des IInkStrokeDisp -Objekts ab.

Syntax

HRESULT GetPacketData(
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  VARIANT *PacketData
);

Parameter

[in, optional] Index

Dies ist optional. Der Ausgangspunkt des nullbasierten Indexes zu einem Paket innerhalb des Strichs. Der Standardwert ISC_FirstElement, der im Enumerationstyp InkSelectionConstants definiert ist, gibt das erste Paket an.

[in, optional] Count

Dies ist optional. Die Anzahl von Punktpaketdatensätzen, die zurückgegeben werden sollen, beginnend mit dem paket, das im startingIndex-Parameter angegeben ist. Der Im Enumerationstyp InkSelectionConstants definierte Standardwert ISC_AllElements gibt alle Punkte an, aus denen die Strichdaten bestehen.

[out, retval] PacketData

Wenn diese Methode zurückgegeben wird, enthält ein signiertes 32-Bit-Ganzzahlarray, das die Paketdaten für die angeforderten Punkte im Strich enthält. Das Array enthält die Daten für den ersten Punkt, dann die Daten für den zweiten Punkt usw.

Weitere Informationen zur VARIANT-Struktur finden Sie unter Verwenden der COM-Bibliothek.

Zurückgegebener Wert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S_OK
Erfolg.
E_POINTER
Ein Parameter enthielt einen ungültigen Zeiger.
E_FAIL
Ein nicht angegebener Fehler ist aufgetreten.
E_OUTOFMEMORY
Das Hilfsobjekt des Stroke-Handlers kann nicht zugewiesen werden.
E_INVALIDARG
Der Strich ist ungültig.
E_INK_EXCEPTION
In der Methode ist eine Ausnahme aufgetreten.
E_UNEXPECTED
Unerwarteter Parameter oder Eigenschaftentyp.

Bemerkungen

Wenn die Anzahl der Pakete im Strich kleiner als die Summe der Parameter "startingIndex " und "pointCount " ist, enthält das zurückgegebene Datenarray Paketinformationen für weniger Punkte als die angeforderte Anzahl.

Um die Beschreibung der Paketdaten abzurufen, verwenden Sie die PacketDescription-Eigenschaft des Strichs. Diese Eigenschaft gibt ein Array von GUID (Globally Unique Identifier) zurück, das angibt, welche Eigenschaftswerte von der GetPacketData-Methode für jeden Punkt zurückgegeben werden. Die PacketProperty-Konstanten enthalten die verfügbaren Paketeigenschaften-GUIDs.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP Tablet PC Edition [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Nicht unterstützt
Zielplattform Windows
Header msinkaut.h

Siehe auch

GetPacketDescriptionPropertyMetrics-Methode

GetPacketValuesByProperty-Methode

IInkStrokeDisp-Schnittstelle

ItemSelectionConstants-Aufzählung

PacketCount-Eigenschaft

PacketDescription-Eigenschaft

PacketSize-Eigenschaft

SetPacketValuesByProperty-Methode