IInkStrokeDisp::Split-Methode (msinkaut.h)

Artikel
02/29/2024

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 aufgeteilt werden soll.

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

[out, retval] NewStroke

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

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_OUTOFMEMORY	Strichhandlerhilfsobjekt kann nicht zugeordnet werden.
E_INVALIDARG	Der Parameter ist ungültig.
E_UNEXPECTED	Unerwarteter Parameter oder Eigenschaftstyp.
E_INK_EXCEPTION	Innerhalb der -Methode ist eine Ausnahme aufgetreten.

Hinweise

Diese Methode fügt den neuen Strich unmittelbar nach dem ursprünglichen Strich in den Strichsatz ein und nummeriert die verbleibenden Strichindizes neu.

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

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

IInkStrokeDisp-Schnittstelle

Freigeben über