CDC::TabbedTextOut

Artykuł
02/27/2013

Wywołanie tej funkcji Członkowskich zapisać ciąg znaków w określonej lokalizacji, rozszerzanie karty do wartości określonej w tablicy pozycje tabulatora.

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 
);

Parametry

x
Określa logiczną współrzędną x punktu początkowego w ciągu.
y
Określa logiczną współrzędną y punktu początkowego w ciągu.
lpszString
Wskazuje ciąg znaków do rysowania.Można przekazywać albo wskaźnik do tablicy znaków lub CString obiektu dla tego parametru.
nCount
Określa liczbę znaków w ciągu.Jeśli nCount jest –1, długość jest obliczana.
nTabPositions
Określa liczbę wartości w tablicy pozycje tabulatora.
lpnTabStopPositions
Wskazuje tablicę zawierającą pozycje tabulatora (w jednostkach logicznych).Tabulatory musi być posortowana rosnąco; najmniejsza wartość x należy pierwszego elementu w tablicy.
nTabOrigin
Określa współrzędną x pozycji początkowej, z którego są rozwinięte karty (w jednostkach logicznych).
str
A CString obiektu zawierającego określonych znaków.

Wartość zwracana

Wymiary ciąg (w jednostkach logicznych) jako CSize obiektu.

Uwagi

Tekst jest napisany w aktualnie wybranej czcionki.Jeśli nTabPositions 0 i lpnTabStopPositions jest NULL, tabulatory są rozwinięte do osiem razy średniej szerokości.

Jeśli nTabPositions 1 karta zatrzymuje są oddzielone od odległości określonej przez pierwszą wartość lpnTabStopPositions tablicy.Jeśli lpnTabStopPositions tablica zawiera więcej niż jedną wartość, tabulator jest ustawiony dla każdej wartości w tablicy do liczby określonej przez nTabPositions.nTabOrigin Parametr umożliwia aplikacji wywołanie TabbedTextOut funkcji dla pojedynczego wiersza.Jeśli aplikacja wywoła funkcję więcej niż raz w z nTabOrigin ustawić na wartość zawsze, funkcja rozwija wszystkich kart do pozycji określonej przez nTabOrigin.

Domyślnie bieżącej pozycji nie jest używany lub aktualizowane przez funkcję.Jeśli aplikacja musi zaktualizować bieżącą pozycję, gdy wywołuje funkcję, aplikacja może wywołać SetTextAlign Członkowskich funkcji z nFlags ustawiona na TA_UPDATECP.Ustawienie tej flagi ignoruje Windows x i y parametrów wezwań do TabbedTextOut, zamiast bieżącego położenia.