Partager via


Fonction SetTextCharacterExtra (wingdi.h)

La fonction SetTextCharacterExtra définit l’espacement intercharacter. L’espacement intercharactaire est ajouté à chaque caractère, y compris les caractères d’arrêt, lorsque le système écrit une ligne de texte.

Syntaxe

int SetTextCharacterExtra(
  [in] HDC hdc,
  [in] int extra
);

Paramètres

[in] hdc

Handle dans le contexte de l’appareil.

[in] extra

Quantité d’espace supplémentaire, en unités logiques, à ajouter à chaque caractère. Si le mode de mappage actuel n’est pas MM_TEXT, le paramètre nCharExtra est transformé et arrondi au pixel le plus proche.

Valeur retournée

Si la fonction réussit, la valeur de retour correspond à l’espacement intercharacteur précédent.

Si la fonction échoue, la valeur de retour est 0x80000000.

Remarques

Cette fonction est principalement prise en charge pour la compatibilité avec les applications existantes. Les nouvelles applications doivent généralement éviter d’appeler cette fonction, car elle est incompatible avec les scripts complexes (scripts qui nécessitent une mise en forme de texte ; L’écriture arabe en est un exemple).

L’approche recommandée est qu’au lieu d’appeler cette fonction, puis TextOut, les applications doivent appeler ExtTextOut et utiliser son paramètre lpDx pour fournir des largeurs.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête wingdi.h (inclure Windows.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

DrawText

Fonctions police et texte

Vue d’ensemble des polices et du texte

GetTextCharacterExtra

Textout