SetTextCharacterExtra-Funktion (wingdi.h)
Die SetTextCharacterExtra-Funktion legt den Interzeichenabstand fest. Jedem Zeichen wird der Interzeichenabstand hinzugefügt, einschließlich Umbruchzeichen, wenn das System eine Textzeile schreibt.
Syntax
int SetTextCharacterExtra(
[in] HDC hdc,
[in] int extra
);
Parameter
[in] hdc
Ein Handle für den Gerätekontext.
[in] extra
Der zusätzliche Speicherplatz in logischen Einheiten, der jedem Zeichen hinzugefügt werden soll. Wenn der aktuelle Zuordnungsmodus nicht MM_TEXT ist, wird der nCharExtra-Parameter transformiert und auf das nächste Pixel gerundet.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert der vorherige Interzeichenabstand.
Wenn die Funktion fehlschlägt, wird der Rückgabewert 0x80000000.
Hinweise
Diese Funktion wird hauptsächlich aus Kompatibilität mit vorhandenen Anwendungen unterstützt. Neue Anwendungen sollten den Aufruf dieser Funktion im Allgemeinen vermeiden, da sie nicht mit komplexen Skripts (Skripts, die Textstrukturierung erfordern; Arabische Schrift ist ein Beispiel dafür).
Der empfohlene Ansatz besteht darin, dass Anwendungen extTextOut aufrufen und den parameter lpDx verwenden sollten, um Breiten anzugeben, anstatt diese Funktion und dann TextOut aufzurufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wingdi.h (windows.h einschließen) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |
Weitere Informationen
Schriftart- und Textfunktionen