GdipAddPathString()

Resultat.i = GdipAddPathString(*path, string.p-unicode, length.l, *family, style.l, emSize.f, @layoutRect.RectF, *format)

*path

[in] Pointeur sur un objet GraphicsPath.

string.p-unicode

[in] Chaîne au format unicode qui sera affichée.

length.l

[in] Nombre de caractères à afficher. Si le paramètre string.p-unicode pointe sur chaîne terminée par un zéro de fin de chaîne, ce paramètre peut être mis à -1.

*family

[in] Pointeur sur un objet FontFamily qui est utilisée pour dessiner le texte (groupe de polices qui ont les styles régulier, gras, italique et gras-italique similaires).

style.l

[in] Elément de l'énumération FontStyle qui représente le style du texte (gras, italique, etc.). Le style peut être une combinaison de un ou plusieurs éléments de l'énumération (utilisez l'opérateur ou logique | ).

emSize.f

[in] Taille em, en unités world (world units), des caractères de la chaîne. C'est la hauteur du carré cadratin englobant le caractère (Carré cadratin : carré imaginaire non imprimée, dont le côté est égal au corps employé, par exemple si le corps vaut 10, le carré fait 10 X 10).

layoutRect.RectF

[in] Variable de type RectF (nombres flottants) qui représente le rectangle englobant le texte. Les valeurs sont en unités world (world units).

*format

[in] Pointeur sur un objet StringFormat qui représente les informations sur la mise en forme du texte telles que les tabulations, l'espacement des lignes et l'alignement.

Cette fonction permet d'ajouter du texte au GraphicsPath.

Le fichier d'exemple affiche la chaîne "PureBasic" + Chr(10) + "Rules" horizontalement avec un alignement à droite par rapport qu rectangle englobant le texte. On peut modifier le paramètre emSize entre 0 et 80 à l'aide du curseur. Le rectangle bleu est le rectangle englobant le texte (layoutRect.RectF) qui est normalement non dessiné. Sur l'exemple qui a une chaîne sur 2 lignes, lorsque l'on agrandit la taille avec le curseur, le texte déborde le bas du rectangle tant que la hauteur complète du texte de la deuxième ligne n'est pas complètement hors du rectangle. Dès que la deuxième ligne déborde complètement, seule la première ligne est dessinée.