CDC::TabbedTextOut

Článek
03/04/2013

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.