Funzione SetTextCharacterExtra (wingdi.h)

La funzione SetTextCharacterExtra imposta la spaziatura intercharacter . La spaziatura intercharacter viene aggiunta a ogni carattere, inclusi i caratteri di interruzione, quando il sistema scrive una riga di testo.

Sintassi

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

Parametri

[in] hdc

Handle nel contesto del dispositivo.

[in] extra

Quantità di spazio aggiuntivo, in unità logiche, da aggiungere a ogni carattere. Se la modalità di mapping corrente non è MM_TEXT, il parametro nCharExtra viene trasformato e arrotondato al pixel più vicino.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è la spaziatura intercharacter precedente.

Se la funzione ha esito negativo, il valore restituito è 0x80000000.

Commenti

Questa funzione è supportata principalmente per la compatibilità con le applicazioni esistenti. Le nuove applicazioni devono in genere evitare di chiamare questa funzione, perché non sono compatibili con script complessi (script che richiedono la modellazione del testo; Lo script arabo è un esempio di questo.

L'approccio consigliato è che invece di chiamare questa funzione e quindi TextOut, le applicazioni devono chiamare ExtTextOut e usare il relativo parametro lpDx per specificare le larghezze.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll

Vedi anche

Drawtext

Funzioni carattere e testo

Panoramica dei tipi di carattere e del testo

GetTextCharacterExtra

TextOut