Condividi tramite


CDC::SetTextJustification

Aggiunge lo spazio per i caratteri di interruzione in una stringa.

int SetTextJustification( 
   int nBreakExtra, 
   int nBreakCount  
);

Parametri

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

  • nBreakCount
    Specifica il numero di caratteri di interruzione di riga.

Valore restituito

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

Note

Un'applicazione può utilizzare le funzioni membro GetTextMetrics per recuperare il carattere di interruzione di un tipo di carattere.

Dopo che la funzione membro SetTextJustification, viene chiamata una chiamata a una funzione restituita al quale TextOut) distribuito anche lo spazio aggiuntivo specificato tra il numero specificato di caratteri di interruzione. Il carattere di interruzione è in genere lo spazio ASCII (32), ma può essere definito da un tipo di carattere come altro carattere.

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

La funzione SetTextJustification può essere utilizzata per allineare una riga contenente le esecuzioni in più caratteri diversi. In questo caso, la riga deve essere creata in minima parte alla volta allineamento e scrivendo ognuna eseguita separatamente.

Poiché gli errori di arrotondamento possono verificarsi durante l'allineamento, il sistema mantiene un termine in esecuzione di errore che definisce l'errore corrente. Nell'allineamento una riga contenente le più esecuzioni, GetTextExtent utilizza automaticamente questo termine di errore in cui calcolerà dopo l'ambito di esecuzione. Ciò consente alla funzione restituita il sfumi l'errore nella nuova esecuzione.

Dopo ogni riga è stata allineata, questa condizione di errore necessario che tali campi vengano cancellati per impedire da essere incorporato nella riga successiva. Il termine possibile che tali campi vengano cancellati chiamando SetTextJustification con nBreakExtra impostato su 0.

Requisiti

Header: afxwin.h

Vedere anche

Riferimenti

Classe CDC

Grafico delle gerarchie

CDC::GetMapMode

CDC::GetTextExtent

CDC::GetTextMetrics

CDC::SetMapMode

CDC::TextOut

SetTextJustification