IInkStrokeDisp::Split-Methode (msinkaut.h)

Teilt den Strich an der angegebenen Position auf dem Strich auf.

Syntax

HRESULT Split(
  [in]          float          SplitAt,
  [out, retval] IInkStrokeDisp **NewStroke
);

Parameter

[in] SplitAt

Der Gleitkommaindexwert, der angibt, wo der Strich geteilt werden soll.

Hinweis Ein Gleitkommaindex ist ein Float-Wert, der eine Position zwischen zwei Punkten im Strich darstellt. Beispiel: Wenn 0,0 der erste Punkt im Strich ist und 1,0 der zweite Punkt im Strich ist, ist 0,5 halbwegs zwischen den ersten und zweiten Punkten. Ebenso stellt ein Gleitkommaindexwert von 37,25 eine Position dar, die 25 Prozent entlang der Linie zwischen den Punkten 37 und 38 des Strichs liegt.
 

[out, retval] NewStroke

Wenn diese Methode zurückgegeben wird, enthält sie einen Zeiger auf das neue IInkStrokeDisp -Objekt, das aus dem geteilten Vorgang erstellt wird.

Zurückgegebener Wert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S_OK
Erfolg.
E_POINTER
Ein Parameter enthielt einen ungültigen Zeiger.
E_OUTOFMEMORY
Das Hilfsobjekt des Stroke-Handlers kann nicht zugewiesen werden.
E_INVALIDARG
Der Parameter ist ungültig.
E_UNEXPECTED
Unerwarteter Parameter oder Eigenschaftentyp.
E_INK_EXCEPTION
In der Methode ist eine Ausnahme aufgetreten.

Bemerkungen

Mit dieser Methode wird der neue Strich unmittelbar nach dem ursprünglichen Strich im Strichsatz eingefügt und die verbleibenden Strichindizes neu nummeriert.

Wenn ein IInkStrokeDisp geteilt wird, bleibt der Anfangsbereich des Strichs die ID des ursprünglichen IInkStrokeDisp. Der Endteil der IInkStrokeDisp wird zu einem neuen IInkStrokeDisp mit einer ID, die größer als die höchste IInkStrokeDisp-ID ist. Wenn sich das ursprüngliche IInkStrokeDisp in einer InkStrokes-Auflistung (außer der Ink.Strokes) befand, verbleibt nur der Anfangsteil in dieser Auflistung.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP Tablet PC Edition [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Nicht unterstützt
Zielplattform Windows
Header msinkaut.h

Siehe auch

IInkStrokeDisp-Schnittstelle