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 |