IInkStrokeDisp::SetPacketValuesByProperty-Methode (msinkaut.h)

Artikel
08/25/2023

Ändert die Paketwerte für eine bestimmte Eigenschaft.

Syntax

HRESULT SetPacketValuesByProperty(
  [in]           BSTR    bstrPropertyName,
  [in]           VARIANT PacketValues,
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  long    *NumberOfPacketsSet
);

Parameter

[in] bstrPropertyName

Der GUID-Bezeichner (Globally Unique Identifier) aus den PacketProperty-Konstanten , der verwendet wird, um auszuwählen, welche Paketdaten festgelegt werden. Verwenden Sie PacketDescription , um die definierten Eigenschaften für diesen Strich zu bestimmen.

[in] PacketValues

Das Array der Paketdatenwerte. Die Methode schlägt fehl, wenn sich einer der Werte im Array außerhalb des Minimal- oder Höchstwerts der Eigenschaft befindet. Um den Wertebereich in der Eigenschaft zu bestimmen, rufen Sie die GetPacketDescriptionPropertyMetrics-Methode auf.

[in, optional] Index

Optional. Der Startindex des zu ändernden Pakets. Der Standardwert ISC_FirstElement, der im ItemSelectionConstants-Enumerationstyp definiert ist, gibt das erste Paket an.

[in, optional] Count

Optional. Gibt die Anzahl der zu ändernden Pakete im Strich und die Anzahl der Werte in PacketValues an. Der Standardwert ISC_AllElements, der im ItemSelectionConstants-Enumerationstyp definiert ist, gibt an, dass alle Pakete geändert werden.

[out, retval] NumberOfPacketsSet

Wenn diese Methode zurückgibt, enthält die tatsächliche Anzahl festgelegter Pakete.

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.
CO_E_CLASSSTRING	Ungültiges GUID-Format.
E_INVALIDARG	Ungültige Variante, Index (außerhalb des Bereichs) oder Eigenschafts-GUID.
E_INK_EXCEPTION	Innerhalb der Methode ist eine Ausnahme aufgetreten.

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

Weitere Informationen

GetPacketDescriptionPropertyMetrics-Methode

IInkStrokeDisp-Schnittstelle

ItemSelectionConstants-Enumeration

PacketPropertyGuids-Konstanten