IInkStrokeDisp::GetPacketValuesByProperty-Methode (msinkaut.h)
Ruft die Daten für eine bekannte Paketeigenschaft aus einem oder mehreren Paketen im Strich ab.
HRESULT GetPacketValuesByProperty(
[in] BSTR PropertyName,
[in, optional] long Index,
[in, optional] long Count,
[out, retval] VARIANT *PacketValues
);
[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.
Diese Methode kann einen dieser Werte zurückgeben.
Rückgabecode | BESCHREIBUNG |
---|---|
|
Erfolg. |
|
Der Strich ist ungültig. |
|
Ein Parameter enthielt einen ungültigen Zeiger. |
|
Es ist ein unbekannter Fehler aufgetreten. |
|
Paketdatenarray kann nicht zugeordnet werden. |
|
Ungültige Index-, Count- oder Paketeigenschaft. |
|
Innerhalb der -Methode ist eine Ausnahme aufgetreten. |
|
Ungültiges GUID-Format. |
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.
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 |
DesiredPacketDescription-Eigenschaft
IsPacketPropertySupported-Methode