CDC::SetTextJustification

int SetTextJustification ( int nBreakExtra, int nBreakCount );

Valeur de retour

Un si la fonction a réussi ; sinon 0.

Paramètres

nBreakExtra

Spécifie l'espace total supplémentaire à ajouter à la ligne de texte (en unités logiques). Si n'est pas l'actuel mode de mappage MM_TEXT, la valeur donnée par ce paramètre est convertie pour le mode de mappage actuel et arrondie à l'unité de périphérique le plus proche.

nBreakCount

Spécifie le nombre de caractères de saut à la ligne.

Remarques

Ajoute l'espace aux caractères dans une chaîne de pause. Une application peut utiliser les fonctions de membre de GetTextMetrics pour récupérer les caractères de la police, une pause.

Après avoir appelé la fonction de membre de SetTextJustification , un appel à une fonction de sortie de texte (comme les TextOut) distribue l'espace supplémentaire spécifié uniformément parmi le nombre spécifié de caractères de la pause. Le caractère de rupture est généralement le caractère espace (ASCII 32), mais peut être défini par une police comme certains autres caractères.

La fonction de membre GetTextExtent est typiquement utilisée avec SetTextJustification. GetTextExtent calcule la largeur d'une ligne donnée avant l'alignement. Une application peut déterminer combien d'espace pour spécifier le paramètre nBreakExtra en soustrayant la valeur retournée par GetTextExtent de la largeur de la chaîne après alignement.

La fonction SetTextJustification peut servir à aligner une ligne qui contient plusieurs pistes dans différentes polices. Dans ce cas, la ligne doit être créée au coup par coup en alignant et en écrit chacun exécuter séparément.

Parce que les erreurs d'arrondi peut se produire au cours de l'alignement, le système conserve un terme d'erreur courante qui définit l'erreur courante. Lorsque l'alignement d'une ligne qui contient plusieurs pistes, GetTextExtent utilise automatiquement ce terme d'erreur lorsqu'il calcule l'étendue de la prochaine exécution. Cela permet à la fonction de sortie de texte pour fondre l'erreur dans la nouvelle course.

Après que chaque ligne a été aligné, ce terme d'erreur doit être effacé pour l'empêcher d'être incorporé dans la ligne suivante. Le terme peut être désactivée en appelant SetTextJustification avec nBreakExtra défini sur 0.

Aperçu de la CDC |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussinbsp ;CDC::GetMapMode, CDC::GetTextExtent, CDC::GetTextMetrics, CDC::SetMapMode, CDC::TextOut, :: SetTextJustification

Index