IInkStrokeDisp::GetPacketData-Methode (msinkaut.h)

Artikel
08/25/2023

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

Optional. Der Ausgangspunkt des nullbasierten Indexes für ein Paket innerhalb des Strichs. Der Standardwert ISC_FirstElement, der im InkSelectionConstants-Enumerationstyp definiert ist, gibt das erste Paket an.

[in, optional] Count

Optional. Die Anzahl der Datensätze für Punktpakete, die zurückgegeben werden sollen, beginnend mit dem paket, das im startingIndex-Parameter angegeben ist. Der Standardwert ISC_AllElements, der im InkSelectionConstants-Enumerationstyp definiert ist, gibt alle Punkte an, aus denen die Strichdaten bestehen.

[out, retval] PacketData

Wenn diese Methode zurückgibt, enthält ein 32-Bit-Ganzzahlarray mit Vorzeichen, 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.

Rückgabewert

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	Es ist ein unbekannter Fehler aufgetreten.
E_OUTOFMEMORY	Strichhandlerhilfsobjekt kann nicht zugeordnet werden.
E_INVALIDARG	Der Strich ist ungültig.
E_INK_EXCEPTION	Innerhalb der -Methode ist eine Ausnahme aufgetreten.
E_UNEXPECTED	Unerwarteter Parameter oder Eigenschaftstyp.

Hinweise

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.

Verwenden Sie die PacketDescription-Eigenschaft des Strichs, um die Beschreibung der Paketdaten abzurufen. 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
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	msinkaut.h
Bibliothek	InkObj.dll