IStrokeBuilder::CreateStroke-Methode (rtscom.h)

Artikel
08/25/2023

Erstellt Striche für ein Freihandobjekt mithilfe von Paketdaten, die aus einem RealTimeStylus Class-Objekt stammen.

Syntax

HRESULT CreateStroke(
  [in]      ULONG                 cPktBuffLength,
  [in]      const LONG            *pPackets,
  [in]      ULONG                 cPacketProperties,
  [in]      const PACKET_PROPERTY *pPacketProperties,
  [in]      FLOAT                 fInkToDeviceScaleX,
  [in]      FLOAT                 fInkToDeviceScaleY,
  [in, out] IInkStrokeDisp        **ppIInkStroke
);

Parameter

[in] cPktBuffLength

Die Anzahl der LONGs im pPackets-Array , nicht die Größe in Bytes. Gültige Werte liegen zwischen 0 und 0x000FFFFF einschließlich.

[in] pPackets

Ein Zeiger auf den Anfang der Paketdaten.

[in] cPacketProperties

Die Anzahl der Longs im pPacketProperties-Puffer . Dies ist die Anzahl von Paketen multipliziert mit der Anzahl der Eigenschaften. Gültige Werte liegen zwischen 0 und einschließlich 32.

[in] pPacketProperties

Der Puffer, der die Paketeigenschaften enthält.

[in] fInkToDeviceScaleX

Der horizontale Oder X-Achse-Konvertierungsfaktor für die horizontale Achse vom Freiraum in die Digitizerkoordinaten.

[in] fInkToDeviceScaleY

Der vertikale Konvertierungsfaktor oder y-Achse für die vertikale Achse vom Freiraum in die Digitizerkoordinaten.

[in, out] ppIInkStroke

Ein Zeiger auf den neu erstellten Strich. Dieser Wert kann NULL sein.

Rückgabewert

Eine Beschreibung der Rückgabewerte finden Sie unter RealTimeStylus-Klassen und -Schnittstellen.

Hinweise

Die Parameter fInkToDeviceScaleX und fInkToDeviceScaleY wirken sich auf die interne Darstellung von Strichen aus, die mit der IStrokeBuilder::CreateStroke-Methode erstellt wurden. Multiplizieren Sie die x-Koordinate im Freihandraum mit fInkToDeviceScaleX , um die x-Koordinate in Digitizereinheiten abzurufen. Multiplizieren Sie die y-Koordinate im Freihandraum mit fInkToDeviceScaleY , um die y-Koordinate in Digitizereinheiten abzurufen.

Verwenden Sie zum Abrufen der Skalierungsparameter die IRealTimeStylus::GetPacketDescriptionData-Methode.

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	rtscom.h
DLL	RTSCom.dll