CDC::DrawText 

Virtual int DrawText ( LPCTSTR lpszString, int nConteggio, LPRECT lpRect, UINT nFormat );

int Dr&awText (const CStringamp;StrLPRECTlpRectUINTnFormat );

Valore restituito

L'altezza del testo se la funzione viene eseguita correttamente.

Parametri

lpszString

Punti alla stringa da trarre. Se nConteggio è – 1, la stringa deve essere con terminazione null.

nConteggio

Specifica il numero di caratteri nella stringa. Se nConteggio è – 1, lpszString si presume essere che lungo puntatore a una stringa null-terminated e DrawText calcola il conteggio di carattere automaticamente.

lpRect

Punta a una struttura RECT o un oggetto CRect che contiene il rettangolo (in coordinate logiche) in cui il testo deve essere formattato.

str

 Un oggetto CString contenente i caratteri specificati da trarre.

nFormat

Specifica il metodo di formattazione del testo. Può essere qualsiasi combinazione dei seguenti valori (mietitrebbia utilizzando l'operatore OR bit per bit):

• DT_BOTTOMnbsp;  Specifica il testo giustificato a fondo. Questo valore deve essere combinato con DT_SI&NGLELINE.
  
  
• DT_CALCRECT   Determina la larghezza e l'altezza del rettangolo. Se vi sono più righe di testo, DrawText utilizzerò la larghezza del rettangolo puntato da lpRect ed estendere la base del rettangolo di vincolato all'ultima riga di testo. Se c'è solo una riga di testo, DrawText modificherà il lato destro del rettangolo affinché esso delimita l'ultimo carattere della riga. In entrambi i casi DrawText restituisce l'altezza del testo formattato, ma non a disegnare il testo.
  
  
• DT_CE&NTERnbsp;  Centra il testo in orizzontale.
  
  
• DT_E&ND_ELLIPSIS o DT_PATH_ELLIPSISnbsp;Sostituisce la parte della stringa specificata con puntini di sospensione, se necessario, affinché il risultato si inserisce nel rettangolo specificato. La stringa specificata non viene modificata se non viene specificato il flag DT_MODIFYSTRING.

  È possibile specificare DT_END_ELLIPSIS di sostituire i caratteri alla fine della stringa, o DT_PATH_ELLIPSIS di sostituire i caratteri della stringa. Se la stringa contiene caratteri barra rovesciata (\), DT_PATH_ELLIPSIS conserva quanto più possibile del testo dopo l'ultima barra rovesciata.

• DT_EXPA&NDTABSnbsp;  Espande i caratteri di tabulazione. Il numero predefinito di caratteri per scheda è otto.
  
  
• DT_EXTER&NALLEADINGnbsp;  Include external leader del font nell'altezza della riga. Normalmente, il leader esterno non è incluso nell'altezza di una riga di testo.
  
  
• DT_LEFT   Allinea il testo a sinistra a filo.
  
  
• DT_MODIFYSTRI&NGnbsp;Modifica la stringa specificata per abbinare il testo visualizzato. Questo flag non ha alcun effetto se non viene specificato il flag DT_END_ELLIPSIS o DT_PATH_ELLIPSIS.

  Nota Alcune combinazioni di bandiera uFormat possono causare la stringa passata essere modificata. Uso DT_MODIFYSTRING con DT_END_ELLIPSIS o DT_PATH_ELLIPSIS potrebbe causare la stringa da modificare, causando un'asserzione in CString l' override.

• DT_&NOCLIPnbsp;  Disegna senza ritaglio. DrawText è più rapido quando viene utilizzato DT_NOCLIP.
  
  
• DT_NOPREFIXnbsp;  Disattiva l'elaborazione dei caratteri prefisso. Normalmente, DrawText interpreta il personaggio di prefisso del tasto di scelta e commerciale (&) come una direttiva per sottolineare il carattere che segue e le due-e commerciale (& &) caratteri prefisso del tasto di scelta rapida come una direttiva per stampare una singola e commerciale. Specificando DT_NOPREFIX, questa elaborazione viene disattivata.
  
  
• DT_PATH_ELLIPSISnbsp; & nbsp;
  
  
• DT_RIGHT   Allinea il testo a destra a filo.
  
  
• DT_SI&NGLELINEnbsp;  Specifica linea singola solo. Ritorni e gli avanzamenti riga non rompono la linea.
  
  
• DT_TABSTOP   Imposta tabulazioni. Il byte di ordine superiore del nFormat è il numero di caratteri per ogni scheda. Il numero predefinito di caratteri per scheda è otto.
  
  
• DT_TOP   Specifica il testo giustificato a cima (singola riga).
  
  
• DT_VCE&NTERnbsp;  Specifica il testo centrato verticalmente (singola riga).
  
  
• DT_WORDBREAK   Specifica l'interruzione delle parole. Le linee sono automaticamente rotte tra le parole, se una parola si estende oltre il bordo del rettangolo specificato da lpRect. Una sequenza di return–linefeed di trasporto sarà anche rompere la linea.

&Notenbsp;I valori DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIPe DT_NOPREFIX non possono essere utilizzati con il valore DT_TABSTOP.

Osservazioni

Chiamare questa funzione membro per formattare il testo nel rettangolo specificato. Formatta il testo da espandendo le tabulazioni in spazi adeguati, l'allineamento del testo a sinistra, a destra, o al centro del rettangolo specificato e spezzare il testo nelle linee che si adattano all'interno del rettangolo specificato. Il tipo di formattazione è specificato da nFormat.

Questa funzione membro utilizza il contesto di periferica selezionata font, colore del testo e colore di sfondo per disegnare il testo. Se non viene utilizzato il formato DT_NOCLIP , DrawText ritaglia il testo in modo che il testo non viene visualizzato all'esterno del rettangolo specificato. Tutta la formattazione si presume di avere più righe, salvo specifica il formato DT_SINGLELINE.

Se il tipo di carattere selezionato è troppo grande per il rettangolo specificato, la funzione membro DrawText non tenta di sostituire un carattere più piccolo.

Se viene specificato il flag DT_CALCRECT , il rettangolo specificato dal lpRect sarà aggiornato per riflettere la larghezza e l'altezza per disegnare il testo.

Se è impostato il flag di allineamento del testo TA_UPDATECP (vedi CDC::SetTextAlign), DrawText visualizzerà il testo a partire dalla posizione corrente, piuttosto che a sinistra del rettangolo specificato. DrawText esegue il wrapping non testo quando è stato impostato il flag TA_UPDATECP (cioè, la bandiera DT_WORDBREAK non avrà alcun effetto).

Il colore del testo può essere impostato da CDC::SetTextColor.

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

Vedere anchenbsp;CDC::SetTextColor, CDC::ExtTextOut, CDC::TabbedTextOut, CDC::TextOut, :: DrawText, RECT, CDC::SetTextAlign