GdipSetStringFormatMeasurableCharacterRanges()

Resultat.i = GdipSetStringFormatMeasurableCharacterRanges(*format, rangeCount.l, *ranges.CharacterRange)

*format

[in] Pointeur sur un objet StringFormat existant.

rangeCount.l

[in] Nombre entier qui spécifie le nombre de plages de caractères du tableau pointé par *ranges.CharacterRange.

*ranges.CharacterRange

[in] Pointeur sur un tableau de variables de type CharacterRange (tableau PB ou allocation d'une zone mémoire) qui spécifient les plages de caractères à mesurer.

Cette fonction permet de définir pour l'objet StringFormat, une série de plages de caractère qui représentent les plages de caractères qui pourront être mesurées par un appel à la fonction GdipMeasureCharacterRanges() pour obtenir les régions dont chacune délimite une plage de positions de caractères de la chaîne spécifiée.

Les variables de type CharacterRange ont deux éléments :

First.l qui spécifie la première position de la plage.

Length.l qui spécifie le nombre de positions dans la plage.

L'exemple assigne autant de plages de caractères d'une longueur d'un caractère qu'il y a de lettres dans la chaîne. Une callback classique Windows est utilisée. A chaque événement #WM_PAINT, les régions sont retrouvées et affichées avec une couleur aléatoire.