CDC::DrawText

Articolo
03/05/2013

Chiamare la funzione membro per formattare il testo nel rettangolo specificato.Per specificare le opzioni di formattazione aggiuntive, utilizzare CDC::DrawTextEx.

virtual int DrawText(
   LPCTSTR lpszString,
   int nCount,
   LPRECT lpRect,
   UINT nFormat 
);
int DrawText(
   const CString& str,
   LPRECT lpRect,
   UINT nFormat 
);

Parametri

lpszString
Punta alla stringa da tracciare.Se nCount è a 1, la stringa deve essere con terminazione null.
nCount
Specifica il numero di caratteri nella stringa.Se nCount è – 1, quindi lpszString siano un puntatore lungo una stringa con terminazione null e DrawText calcola il numero di caratteri automaticamente.
lpRect
I punti su RECT struttura o oggetto CRect che contiene il rettangolo (coordinate logiche) dove il testo deve essere formattato.
str
Un oggetto CString che contiene i caratteri specificati da tracciare.
nFormat
Specifica il metodo di formattazione del testo.Può essere qualsiasi combinazione dei valori descritti per il parametro uFormat in DrawText in Windows SDK.(associazione utilizzando l'operatore OR bit):

[!NOTA]

Alcune combinazioni di flag uFormat possono determinare la stringa passata a essere modificato.Utilizzando DT_MODIFYSTRING con DT_END_ELLIPSIS o DT_PATH_ELLIPSIS può causare una stringa venga modificato, causando un'asserzione nell'override CString.i valori DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIPe DT_NOPREFIX non possono essere utilizzati con il valore DT_TABSTOP.

Valore restituito

Altezza del testo se la funzione ha esito positivo.

Note

Formattare il testo espandendo tabulazioni in spazi appropriati, allineare il testo a sinistra, a destra, o il centro del rettangolo specificato e interrompere il testo nelle righe che corrispondono all'interno del rettangolo specificato.Il tipo di formattazione è specificato da nFormat.

Questa funzione membro utilizza il tipo selezionata, il colore del testo e il colore di sfondo del contesto di dispositivo per creare il testo.A meno che il formato DT_NOCLIP venga utilizzato, DrawText tagliare il testo in modo che il testo non sia esterno del rettangolo specificato.La formattazione deve includere più righe a meno che il formato DT_SINGLELINE venga fornito.

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

Se il flag DT_CALCRECT viene specificato, il rettangolo specificato da lpRect verrà aggiornato per riflettere la larghezza e l'altezza necessarie per creare testo.

Se il flag di allineamento del testo TA_UPDATECP è stato impostato CDC::SetTextAlign(vedere), DrawText visualizzare il testo a partire dalla posizione corrente, anziché a sinistra del rettangolo specificato.DrawText non eseguirà il wrapping del testo quando il flag TA_UPDATECP è stato impostato ovvero il flag DT_WORDBREAK non avrà effetto).

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