CDC::TabbedTextOut

Článek
06/10/2015

Volání funkce tohoto člena zapisovat řetězec znaků v zadaném umístění, rozšířením karty hodnoty zadané v poli pozice zarážky tabulátoru.

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
Určuje logické souřadnice x bodu počáteční řetězec.
y
Určuje logické souřadnici y počáteční bod řetězec.
lpszString
Odkazuje na řetězec znaků kreslení.Předáte buď ukazatel do pole znaků nebo CString objektu pro tento parametr.
nCount
Určuje počet znaků v řetězci.Pokud nCount -1, je délka počítá.
nTabPositions
Určuje počet hodnot v poli pozice zarážky tabulátoru.
lpnTabStopPositions
Odkazuje na pole obsahující pozice zarážky tabulátoru (v logické jednotky).Zarážky tabulátoru, musí být seřazeny vzestupně; nejmenší hodnota x musí být první položky v poli.
nTabOrigin
Určuje souřadnici x počáteční pozici, ze které jsou rozbaleny karty (v logické jednotky).
str
A CString objekt obsahující zadané znaky.

Vrácená hodnota

Rozměry jako řetězec (v logické jednotky) CSize objektu.

Poznámky

Text je zapsán v aktuálně vybrané písmo.Pokud nTabPositions 0 a lpnTabStopPositions je NULL, karty jsou rozbaleny osminásobek průměrné znak šířku.

Pokud nTabPositions je 1 kartu zastaví jsou odděleny první hodnotu určenou vzdálenost lpnTabStopPositions pole.Pokud lpnTabStopPositions pole obsahuje více než jednu hodnotu, je pro každou hodnotu v poli číslo určené nastavit zarážku nTabPositions . nTabOrigin Parametr umožňuje aplikaci volání TabbedTextOut funkce pro jeden řádek.Pokud aplikace volá funkci více než jednou se nTabOrigin nastavena na stejnou hodnotu pokaždé, rozbalí všechny karty vzhledem k poloze určené funkce nTabOrigin .

Aktuální pozice není standardně používá nebo aktualizované funkce.Potřebuje aktualizovat aktuální pozici při volá funkci aplikace, aplikace může zavolat SetTextAlign členské funkce s nFlags nastavena na TA_UPDATECP.Pokud je tento příznak nastaven, systém ignoruje x a y parametry na následných výzev k TabbedTextOut , místo toho použít aktuální pozici.