CDC::ExtTextOut

Articolo
03/05/2013

Chiamare la funzione membro per scrivere una stringa di caratteri in un'area rettangolare tramite il tipo attualmente selezionata.

virtual BOOL ExtTextOut(
   int x,
   int y,
   UINT nOptions,
   LPCRECT lpRect,
   LPCTSTR lpszString,
   UINT nCount,
   LPINT lpDxWidths 
);
BOOL ExtTextOut(
   int x,
   int y,
   UINT nOptions,
   LPCRECT lpRect,
   const CString& str,
   LPINT lpDxWidths 
);

Parametri

x
Specifica la coordinata x logica della cella di carattere per il primo carattere della stringa specificata.
y
Specifica la coordinata y logica della parte superiore della cella di carattere per il primo carattere della stringa specificata.
nOptions
Specifica il tipo del rettangolo.Questo parametro può essere uno, sia, o nessuno dei valori seguenti:
- ETO_CLIPPED specifica che il testo viene tagliato al rettangolo.
- ETO_OPAQUE specifica che riempie di colore di sfondo correnti il rettangolo.È possibile impostare ed eseguire una query sul colore di sfondo corrente con funzioni membro GetBkColor e SetBkColor ).
lpRect
Punta a una struttura RECT che determina le dimensioni del rettangolo.Questo parametro può essere NULL.È anche possibile passare un oggetto CRect per questo parametro.
lpszString
Punta alla stringa di caratteri specificata da tracciare.È anche possibile passare un oggetto CString per questo parametro.
nCount
Specifica il numero di caratteri della stringa.
lpDxWidths
Punta a una matrice di valori che indicano la distanza tra le origini delle celle del carattere adiacenti.Ad esempio, le unità logiche deilpDxWidths[] separeranno le origini della cella dei caratteri e delle celle dei caratteri + 1.Se lpDxWidths è NULL, ExtTextOut utilizza la spaziatura predefinita tra caratteri.
str
Un oggetto CString che contiene i caratteri specificati da tracciare.

Valore restituito

Diverso da zero se la funzione ha esito positivo; in caso contrario 0.

Note

La regione rettangolare sia opaca (riempito con un colore di sfondo corrente e può essere un'area di ridimensionamento.

Se nOptions è 0 e lpRect è NULL, la funzione scrive il testo nel contesto di dispositivo senza utilizzare un'area rettangolare.Per impostazione predefinita, la posizione corrente non viene utilizzata o aggiornata dalla funzione.Se un'applicazione deve aggiornare la posizione corrente quando chiama ExtTextOut, l'applicazione può chiamare la funzione membro SetTextAlignCDC con nFlags impostato su TA_UPDATECP.Quando il flag è impostato, Windows ignora la x e y sulle chiamate successive a ExtTextOut e utilizza la posizione corrente anziché.Quando un'applicazione utilizza TA_UPDATECP per aggiornare la posizione corrente, ExtTextOut imposta la posizione corrente alla fine della riga di testo precedente o nella posizione specificata dall'ultimo elemento della matrice indicata da lpDxWidths, ogni è maggiore.