IInkDisp::CreateStroke-Methode (msinkaut.h)

Erstellt ein IInkStrokeDisp-Objekt aus einem Array von Paketdateneingabewerten.

Syntax

HRESULT CreateStroke(
  [in]          VARIANT        PacketData,
  [in]          VARIANT        PacketDescription,
  [out, retval] IInkStrokeDisp **Stroke
);

Parameter

[in] PacketData

Gibt das Array der Paketdaten an. Bei den Daten handelt es sich um ein Array von Int32-Werten, die in der Reihenfolge genommen das Array von Punkten (x0, y0), (x1, y1) bilden, das innerhalb eines Variant-Elements an die -Methode übergeben wird.

Weitere Informationen zur VARIANT-Struktur finden Sie unter Verwenden der COM-Bibliothek.

[in] PacketDescription

Ein reservierter Parameter, der derzeit nicht implementiert ist.

[out, retval] Stroke

Wenn diese Methode zurückgibt, enthält einen Zeiger auf den neu erstellten Strich.

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_INVALIDARG
Ungültiger VARIANT-Typ (nur VT_ARRAY | VT_I4 unterstützt).
E_INK_EXCEPTION
Innerhalb der -Methode ist eine Ausnahme aufgetreten.
E_OUTOFMEMORY
Speicher zum Erstellen des neuen Strichs kann nicht zugeordnet werden.

Hinweise

Die minimalen und maximalen Werte jedes Punkts im Punktarray sind LONG_MIN bzw. LONG_MAX. Diese Punkte definieren jedoch ein Freihandbereichsrechteck, dessen maximale Breite oder Höhe LONG_MAX nicht überschreiten kann. Aus diesem Fall kann der Unterschied zwischen der minimalen und der maximalen x-Koordinate oder den minimalen und maximalen y-Koordinaten LONG_MAX nicht überschreiten.

Anforderungen

   
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

CreateStrokes-Methode

IInkDisp

InkDisp-Klasse