CDC::ExtTextOut

Článek
03/04/2013

Volání funkce tohoto člena zapisovat řetězec znaků v obdélníkové oblasti pomocí aktuálně vybrané písmo.

virtual BOOL ExtTextOut(
   int x,
   int y,
   UINT nOptions,
   LPCRECT lpRect,
   LPCTSTR lpszString,
   UINT nCount,
   LPINT lpDxWidths 
);
BOOL ExtTextOut(
   int x,
   int y,
   UINT nOptions,
   LPCRECT lpRect,
   const CString& str,
   LPINT lpDxWidths 
);

Parametry

x
Určuje logické souřadnici x buňky znaku pro první znak zadaného řetězce.
y
Určuje logické souřadnici y horní buňku znaku pro první znak v zadaném řetězci.
nOptions
Určuje typ obdélník.Tento parametr může být jedna, obojí nebo ani jedna z následujících hodnot:
- ETO_CLIPPED Určuje, že text je oříznut obdélníku.
- ETO_OPAQUE Určuje, že aktuální barvou pozadí výplně obdélníku.(Můžete nastavit a dotaz na aktuální barvu pozadí SetBkColor a GetBkColor funkce členů.)
lpRect
Odkazuje RECT struktury, která určuje rozměry obdélníku.Tento parametr může být NULL.Můžete také předat CRect objektu pro tento parametr.
lpszString
Body na řetězec zadaný znak vykreslit.Můžete také předat CString objektu pro tento parametr.
nCount
Určuje počet znaků v řetězci.
lpDxWidths
Odkazuje na pole hodnoty, které označují vzdálenost mezi různého buňky sousedící znak.Například lpDxWidths i logické jednotky budou odděleny původ znaku buňky i a znak buněk i + 1.Pokud lpDxWidths je NULL, ExtTextOut používá výchozí mezery mezi znaky.
str
A CString objekt obsahující zadané znaky se stanoví.

Vrácená hodnota

Nenulová hodnota, pokud je tato funkce úspěšná. jinak 0.

Poznámky

Obdélníkové může být neprůhledné (vyplněn aktuální barvou pozadí) a může být oblast oříznutí.

Pokud nOptions 0 a lpRect je NULL, funkce zapíše text do kontextu zařízení bez použití obdélníkové oblasti.Aktuální pozice není standardně používá nebo aktualizované funkce.Pokud aplikace potřebuje aktualizovat aktuální pozici, když zavolá ExtTextOut , aplikace může zavolat CDC členské funkce SetTextAlign s nFlags nastavena na TA_UPDATECP.Pokud je tento příznak nastaven, systém ignoruje x a y v následných výzev k ExtTextOut a místo toho použije aktuální pozici.Pokud aplikace používá TA_UPDATECP aktualizovat aktuální pozice ExtTextOut nastaví aktuální pozice na konec předchozího řádku textu nebo na místo určené poslední prvek pole odkazuje lpDxWidths , podle toho, co je větší.