IInkStrokeDisp ::Split, méthode (msinkaut.h)

Fractionne le trait à l’emplacement spécifié sur le trait.

Syntaxe

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

Paramètres

[in] SplitAt

Valeur d’index à virgule flottante qui représente l’emplacement où fractionner le trait.

Note Un index à virgule flottante est une valeur flottante qui représente un emplacement entre deux points dans le trait. Par exemple, si 0,0 est le premier point du trait et que 1,0 est le deuxième point du trait, 0,5 est à mi-chemin entre les premiers et les deuxième points. De même, une valeur d’index à virgule flottante de 37,25 représente un emplacement de 25 % le long de la ligne entre les points 37 et 38 du trait.
 

[out, retval] NewStroke

Lorsque cette méthode est retournée, contient un pointeur vers le nouvel objet IInkStrokeDisp créé à partir de l’opération de fractionnement.

Valeur renvoyée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
Opération réussie.
E_POINTER
Un paramètre contenait un pointeur non valide.
E_OUTOFMEMORY
Impossible d’allouer l’objet d’assistance du gestionnaire Stroke.
E_INVALIDARG
Le paramètre n’est pas valide.
E_UNEXPECTED
Paramètre ou type de propriété inattendu.
E_INK_EXCEPTION
Une exception s’est produite à l’intérieur de la méthode.

Remarques

Cette méthode insère le nouveau trait immédiatement après le trait d’origine dans le jeu de traits et renumérot les indices de trait restants.

Lorsqu’un IInkStrokeDisp est fractionné, la partie de début du trait reste l’ID de l’IInkStrokeDisp d’origine. La partie de fin de iInkStrokeDisp devient un nouvel IInkStrokeDisp avec un ID supérieur à l’ID IInkStrokeDisp le plus élevé. Si l’IInkStrokeDisp d’origine se trouvait dans une collection InkStrokes (autre que Ink.Strokes), seule la partie de début reste dans cette collection.

Exigences

Prérequis Valeur
Client minimum requis Windows XP Tablet PC Edition [applications de bureau uniquement]
Serveur minimal pris en charge Aucun pris en charge
plateforme cible Windows
En-tête msinkaut.h

Voir également

IInkStrokeDisp, interface