IInkStrokeDisp::Split-Methode (msinkaut.h)

  • Artikel

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