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

Drawtext

Schriftart- und Textfunktionen

Übersicht über Schriftarten und Text

GetTextCharacterExtra

Textout