IInkStrokeDisp::GetPacketValuesByProperty-Methode (msinkaut.h)

Artikel
08/25/2023

Ruft die Daten für eine bekannte Paketeigenschaft aus einem oder mehreren Paketen im Strich ab.

Syntax

HRESULT GetPacketValuesByProperty(
  [in]           BSTR    PropertyName,
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  VARIANT *PacketValues
);

Parameter

[in] PropertyName

Der Bezeichner aus den PacketProperty-Konstanten , der verwendet wurde, um auszuwählen, welche Paketdaten abgerufen werden.

Weitere Informationen zum BSTR-Datentyp finden Sie unter Verwenden der COM-Bibliothek.

[in, optional] Index

Optional. Der Startpunkt 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 Punkte, aus denen die Strichdaten bestehen. Der Standardwert ISC_AllElements, der im InkSelectionConstants-Enumerationstyp definiert ist, gibt alle Punkte an, aus denen die Strichdaten bestehen.

[out, retval] PacketValues

Wenn diese Methode zurückgibt, enthält ein Array von ganzzahligen 32-Bit-Zeichen, das den Wert der angeforderten PacketProperty für jeden Punkt angibt, der von der Strich angefordert wird.

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.
TPC_E_INVALID_STROKE	Der Strich ist ungültig.
E_POINTER	Ein Parameter enthielt einen ungültigen Zeiger.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
E_OUTOFMEMORY	Paketdatenarray kann nicht zugeordnet werden.
E_INVALIDARG	Ungültige Index-, Count- oder Paketeigenschaft.
E_INK_EXCEPTION	Innerhalb der -Methode ist eine Ausnahme aufgetreten.
CO_E_CLASSSTRING	Ungültiges GUID-Format.

Hinweise

Eine bestimmte Paketeigenschaft ist für ein bestimmtes IInkStrokeDisp-Objekt möglicherweise nicht verfügbar. Ein Tablet-PC verfügt möglicherweise über mehrere Tablets für die Benutzereingabe. Die InkTablets-Auflistung enthält eine Liste aller Tablets, die an den Tablet-PC angefügt sind. Verwenden Sie die IsPacketPropertySupported-Methode , um zu ermitteln, ob eine bestimmte Paketeigenschaft von einem bestimmten IInkTablet-Objekt oder von allen verfügbaren Tablets unterstützt wird. Verwenden Sie außerdem die DesiredPacketDescription-Eigenschaft des Freihandsammlers , um zu steuern, welche Paketeigenschaften für neue Striche gesammelt werden.

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