Funzione SetTextJustification (wingdi.h)

Articolo
08/27/2023

La funzione SetTextJustification specifica la quantità di spazio che il sistema deve aggiungere ai caratteri di interruzione in una stringa di testo. Lo spazio viene aggiunto quando un'applicazione chiama le funzioni TextOut o ExtTextOut .

Sintassi

BOOL SetTextJustification(
  [in] HDC hdc,
  [in] int extra,
  [in] int count
);

Parametri

[in] hdc

Handle nel contesto del dispositivo.

[in] extra

Spazio aggiuntivo totale, in unità logiche, da aggiungere alla riga di testo. Se la modalità di mapping corrente non è MM_TEXT, il valore identificato dal parametro nBreakExtra viene trasformato e arrotondato al pixel più vicino.

[in] count

Numero di caratteri di interruzione nella riga.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

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

Commenti

Il carattere di interruzione è in genere il carattere di spazio (ASCII 32), ma può essere definito da un carattere come un altro carattere. La funzione GetTextMetrics può essere usata per recuperare il carattere di interruzione di un tipo di carattere.

La funzione TextOut distribuisce in modo uniforme lo spazio aggiuntivo specificato tra i caratteri di interruzione nella riga.

La funzione GetTextExtentPoint32 viene sempre usata con la funzione SetTextJustification . A volte la funzione GetTextExtentPoint32 prende in considerazione la giustificazione quando si calcola la larghezza di una riga specificata prima della giustificazione e talvolta non viene eseguita. Per altre informazioni su questo argomento, vedere GetTextExtentPoint32. Questa larghezza deve essere nota prima che sia possibile calcolare un valore nBreakExtra appropriato.

SetTextJustification può essere usato per giustificare una riga contenente più stringhe in tipi di carattere diversi. In questo caso, ogni stringa deve essere giustificata separatamente.

Poiché gli errori di arrotondamento possono verificarsi durante la giustificazione, il sistema mantiene un termine di errore in esecuzione che definisce il valore di errore corrente. Quando si giustifica una riga contenente più esecuzioni, GetTextExtentPoint usa automaticamente questo termine di errore quando calcola l'estensione dell'esecuzione successiva, consentendo a TextOut di combinare l'errore nella nuova esecuzione. Dopo aver giustificato ogni riga, questo termine di errore deve essere cancellato per evitare che venga incorporata nella riga successiva. Il termine può essere cancellato chiamando SetTextJustification con nBreakExtra impostato su zero.

Requisiti


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