Méthode IInkStrokeDisp ::Split (msinkaut.h)

Article
02/29/2024

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 de fractionnement du 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 dans le trait et 1,0 est le deuxième point dans le trait, 0,5 est à mi-chemin entre le premier et le deuxième point. De même, une valeur d’index à virgule flottante de 37,25 représente un emplacement de 25 pour cent 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 retournée

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

Code de retour	Description
S_OK	Réussite.
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érote les index de trait restants.

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP Édition Tablette PC [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	msinkaut.h
Bibliothèque	InkObj.dll

Voir aussi

IInkStrokeDisp, interface

Partager via