CDC::TabbedTextOut
Chiamare la funzione membro per scrivere una stringa di caratteri nella posizione specificata, l'espansione le schede sui valori specificati nella matrice di posizioni tabstop.
virtual CSize TabbedTextOut(
int x,
int y,
LPCTSTR lpszString,
int nCount,
int nTabPositions,
LPINT lpnTabStopPositions,
int nTabOrigin
);
CSize TabbedTextOut(
int x,
int y,
const CString& str,
int nTabPositions,
LPINT lpnTabStopPositions,
int nTabOrigin
);
Parametri
x
Specifica la coordinata x del punto iniziale della stringa.y
Specifica la coordinata y logica del punto iniziale della stringa.lpszString
Punta alla stringa di caratteri da tracciare.È possibile passare un puntatore a una matrice di caratteri o un oggetto CString per questo parametro.nCount
Specifica il numero di caratteri della stringa.Se nCount è a 1, la lunghezza viene calcolato.nTabPositions
Specifica il numero di valori nella matrice di posizioni tabstop.lpnTabStopPositions
Punta a una matrice contenente le posizioni tabstop (in unità logiche).Le tabulazioni devono essere ordinate in ordine crescente, il valore x più piccolo deve essere il primo elemento della matrice.nTabOrigin
Specifica la coordinata x della posizione iniziale da cui le schede sono espanse (in unità logiche).str
Un oggetto CString che contiene i caratteri specificati.
Valore restituito
Le dimensioni della stringa (in unità logiche) come oggetto CSize.
Note
Il testo viene scritto nel carattere attualmente selezionata.Se nTabPositions è 0 e lpnTabStopPositions è NULL, schede sono espanse a otto volte la larghezza media del carattere.
Se nTabPositions è 1, tabulazioni sono separate dalla distanza specificata dal primo valore nella matrice lpnTabStopPositions.Se la matrice lpnTabStopPositions contiene più di un valore, una tabulazione è impostata per ogni valore nella matrice, fino al numero specificato da nTabPositions.Il parametro nTabOrigin consente a un'applicazione chiamare la funzione TabbedTextOut più volte per una sola riga.Se l'applicazione chiama più volte la funzione con nTabOrigin ogni volta impostato sullo stesso valore, la funzione espandere tutte le schede nella posizione specificata da nTabOrigin.
Per impostazione predefinita, la posizione corrente non viene utilizzata o aggiornata dalla funzione.Se un'applicazione deve aggiornare la posizione corrente nella chiamata alla funzione, l'applicazione può chiamare la funzione membro SetTextAlign con nFlags impostato su TA_UPDATECP.Quando il flag è impostato, Windows ignora i parametri x e y sulle chiamate successive a TabbedTextOut, utilizzando la posizione corrente anziché.
Requisiti
Header: afxwin.h