CDC::DrawText

Článek
03/04/2013

Volání funkce tohoto člena formátování textu v daném obdélníku.Další možnosti formátování pomocí CDC::DrawTextEx.

virtual int DrawText(
   LPCTSTR lpszString,
   int nCount,
   LPRECT lpRect,
   UINT nFormat 
);
int DrawText(
   const CString& str,
   LPRECT lpRect,
   UINT nFormat 
);

Parametry

lpszString
Body se stanoví na řetězec.Pokud nCount je-1, musí být řetězec zakončený hodnotou null.
nCount
Určuje počet znaků v řetězci.Pokud nCount -1, pak je lpszString považován za dlouhý ukazatel na řetězec zakončený a DrawText automaticky vypočítá počet znaků.
lpRect
Odkazuje RECT struktury nebo CRect objekt obsahující obdélník (v logické souřadnice), ve kterém je text formátovat.
str
A CString objekt obsahující zadané znaky se stanoví.
nFormat
Určuje způsob formátování textu.Může být kombinací hodnot popsaných pro uFormat parametr v DrawText v .(kombinovat bitového operátoru):

[!POZNÁMKA]

Některé uFormat kombinace příznak může způsobit předané řetězec, který chcete upravit.Pomocí DT_MODIFYSTRING buď DT_END_ELLIPSIS nebo DT_PATH_ELLIPSIS mohou způsobit řetězec, který chcete upravit, příčinou nepravdivých v CString přepsat.The values DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIP, and DT_NOPREFIX cannot be used with the DT_TABSTOP value.

Vrácená hodnota

Výška textu, pokud je úspěšná.

Poznámky

Formátování textu rozhodlo vhodné prostory, zarovnání textu vlevo, vpravo, nebo na střed obdélníku dané karty a rozdělení textu do řádků, které se vejdou do dané obdélník.Je určen typ formátování nFormat .

Členské funkce používá k vykreslování textu kontext zařízení vybrané písmo, barvu textu a pozadí.Pokud DT_NOCLIP , bude použit formát DrawText klipy text tak, aby text nezobrazí mimo danou obdélník.Veškeré formátování považován za mít více řádků, pokud DT_SINGLELINE je uveden formát.

Pokud vybrané písmo je příliš velký pro zadaný obdélník DrawText členské funkce nebude pokoušet nahradit menší písmo.

Pokud DT_CALCRECT zadán příznak obdélníku určené lpRect bude aktualizován tak, aby odrážely šířku a výšku potřebné pro text.

Pokud TA_UPDATECP byl nastaven příznak zarovnání textu (viz CDC::SetTextAlign), DrawText zobrazí text spuštění v aktuální pozici a nikoli vlevo od dané obdélník.DrawTexttext nebude obtékat při TA_UPDATECP byl nastaven příznak (, DT_WORDBREAK příznak nebude mít žádný účinek).

Může nastavit barvu textu CDC::SetTextColor.