CDC::SetTextJustification

int SetTextJustification ( int nBreakExtra, int nBreakCount );

Valore restituito

Uno se la funzione ha esito positivo; in caso contrario 0.

Parametri

nBreakExtra

Specifica lo spazio totale da aggiungere alla riga di testo (in unità logiche). Se la modalità di mapping corrente non è MM_TEXT, il valore dato da questo parametro viene convertito in modalità corrente mappatura e arrotondato all'unità più vicina del dispositivo.

nBreakCount

Specifica il numero di caratteri di interruzione di linea.

Osservazioni

Aggiunge lo spazio per i caratteri di interruzione in una stringa. Un'applicazione può utilizzare le funzioni membro GetTextMetrics per recuperare il carattere di interruzione del font.

Dopo la chiamata della funzione membro di SetTextJustification , una chiamata a una funzione di output di testo (ad esempio TextOut) distribuisce lo spazio aggiuntivo specificato in modo uniforme tra il numero specificato di caratteri di interruzione. Il personaggio di pausa è di solito il carattere di spazio (ASCII 32), ma può essere definito da un font come qualche altro personaggio.

La funzione membro GetTextExtent viene in genere utilizzata con SetTextJustification. GetTextExtent calcola la larghezza di una determinata linea prima di allineamento. Un'applicazione in grado di determinare la quantità di spazio per specificare il parametro nBreakExtra sottraendo il valore restituito da GetTextExtent dalla larghezza della stringa dopo aver allineamento.

La funzione SetTextJustification consente di allineare una riga che contiene più eseguito in diversi tipi di carattere. In questo caso, la linea deve essere creata frammentario allineando e scrittura ognuno eseguito separatamente.

Perché l'arrotondamento errori può verificarsi durante l'allineamento, il sistema mantiene un termine di errore in esecuzione che definisce l'errore corrente. Quando una riga che contiene molteplici esecuzioni di allineamento, GetTextExtent utilizza automaticamente questo termine di errore quando calcola l'entità dell'esecuzione successiva. In questo modo la funzione di output di testo a mescolarsi l'errore nella nuova corsa.

Dopo ogni riga è stato allineato, questo termine di errore deve essere cancellato per impedire di essere incorporata nella riga successiva. Il termine può essere liquidato chiamando SetTextJustification con nBreakExtra impostato su 0.

CDC pa&noramica |nbsp; Membri della classe | Gerarchia Chart

Vedere anchenbsp;CDC::GetMapMode, CDC::GetTextExtent, CDC::GetTextMetrics, CDC::SetMapMode, CDC::TextOut, :: SetTextJustification

Index