CDC::ExtTextOut

Virtual BOOL ExtTextOut ( int x, int y, UINT nOptions, LPCRECT lpRect, LPCTSTR lpszString, UINT nConteggio, LPINT lpDxWidths );

BOOL ExtTextOut (int x, int y, UINT nOptions, LPCRECT lpRectconst CString&StrLPINTlpDxWidths );

Valore restituito

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

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 di rettangolo. Questo parametro può essere uno, entrambi o nessuno dei seguenti valori:

lpRect

Punti 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

Punti per la stringa di caratteri specificato da trarre. È anche possibile passare un oggetto CString per questo parametro.

nConteggio

Specifica il numero di caratteri nella stringa.

lpDxWidths

Punti a una matrice di valori che indicano la distanza tra le origini di celle adiacenti carattere. Per esempio, lpDxWidths[mi] unità logiche separerà le origini del personaggio cella ho e carattere cella io + 1. Se lpDxWidths è NULL, ExtTextOut utilizza la spaziatura predefinita tra i caratteri.

str

 Un oggetto CString contenente i caratteri specificati da trarre.

Osservazioni

Chiamare questa funzione membro per scrivere una stringa di caratteri all'interno di un'area rettangolare utilizzando il carattere attualmente selezionato. L'area rettangolare può essere opaco (riempito con il colore di sfondo corrente), e può essere un area di ritaglio.

Se nOptions è 0 e lpRect è NULL, la funzione scrive testo per il contesto di periferica senza l'utilizzo di un'area rettangolare. Per impostazione predefinita, la posizione corrente non è usata o aggiornata dalla funzione. Se un'applicazione deve aggiornare la posizione corrente quando chiama ExtTextOut, l'applicazione può chiamare la funzione membro CDC SetTextAlign con nFlags impostato su TA_UPDATECP. Quando questo flag è impostato, Windows ignora x e y in successive chiamate a ExtTextOut e utilizza invece la posizione corrente. Quando un'applicazione utilizza TA_UPDATECP per aggiornare la posizione corrente, ExtTextOut imposta la posizione corrente o alla fine della riga di testo precedente, o posizione specificata dall'ultimo elemento della matrice a cui punta lpDxWidths, qualunque sia maggiore.

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

Vedere anchenbsp;CDC::setTextAlign, CDC::TabbedTextOut, CDC::TextOut, CDC::GetBkColor, CDC::SetBkColor, CDC::SetTextColor, :: ExtTextOut, RECT

Index