Condividi tramite


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