CDC::SetTextJustification
Ajoute l'espace aux caractères de soulignement dans une chaîne.
int SetTextJustification(
int nBreakExtra,
int nBreakCount
);
Paramètres
nBreakExtra
Spécifie l'ensemble de l'espace supplémentaire à ajouter à la ligne de texte (en unités logiques). Si le mode de mappage en cours n'est pas MM_TEXT, la valeur spécifiée par ce paramètre est convertie en mode de mappage actuel et arrondie à l'unité la plus proche.nBreakCount
Spécifie le nombre de caractères de soulignement dans la ligne.
Valeur de retour
Un si la fonction est réussie ; sinon 0.
Notes
Une application peut utiliser les fonctions membres d' GetTextMetrics pour récupérer le caractère de soulignement d'une police.
Une fois la fonction membre d' SetTextJustification appelée, un appel à une fonction de texte sortie (par exemple TextOut) distribue l'espace supplémentaire spécifié même entre le nombre spécifié de caractères de soulignement. Le caractère de soulignement est généralement l'espace (ASCII 32), mais peut être défini par une police comme un autre caractère.
La fonction membre GetTextExtent est généralement utilisée avec SetTextJustification. GetTextExtent calcule la largeur d'une ligne donnée avant alignement. Une application peut déterminer la quantité d'espace à spécifier dans le paramètre d' nBreakExtra en soustrayant la valeur est retourné par GetTextExtent de la largeur de la chaîne après alignement.
La fonction d' SetTextJustification peut être utilisée pour aligner une ligne contenant plusieurs séries dans des polices. Dans ce cas, la ligne doit être créée de façon disparate en alignant et en écrivant chaque série séparément.
Étant donné que les erreurs d'arrondi peuvent se produire pendant l'alignement, le système conserve un terme en cours de exécution d'erreur qui définit l'erreur actuelle. En alignant une ligne contenant plusieurs séries, GetTextExtent utilise automatiquement ce terme d'erreur lorsqu'il calcule l'étendue de l'exécution. Cela permet à la fonction de texte sortie pour fusionner l'erreur dans la nouvelle passe.
Après chaque ligne a été alignée, ce terme d'erreur doit être supprimé pour l'empêcher d'être incorporé dans la ligne suivante. Le terme peut être supprimé en appelant SetTextJustification avec nBreakExtra a la valeur 0.
Configuration requise
Header: afxwin.h