CDC::DrawText

Artykuł
02/27/2013

Wywołanie tej funkcji Członkowskich formatować tekst w danym prostokąta.Aby określić dodatkowe opcje formatowania, użyj CDC::DrawTextEx.

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

Parametry

lpszString
Wskazuje ciąg wyciągnąć.Jeśli nCount jest –1, ciąg musi być zakończony znakiem null.
nCount
Określa liczbę znaków w ciągu.Jeśli nCount jest następnie –1, lpszString zakłada się wskaźnik długi ciąg zakończony znakiem null i DrawText automatycznie oblicza liczba znaków.
lpRect
Wskazuje na RECT struktury lub CRect obiektu zawierającego prostokąta (w logiczne współrzędne) w którym tekst ma zostać sformatowany.
str
A CString obiektu zawierającego wyciągnąć określonych znaków.
nFormat
Określa metodę formatowania tekstu.Może być dowolną kombinacją wartości opisane dla uFormat parametr w DrawText w Windows SDK.(łączenie za pomocą operatora OR bitowe):

[!UWAGA]

Niektóre uFormat kombinacje flagi może spowodować przekazany ciąg ma zostać zmodyfikowana.Za pomocą DT_MODIFYSTRING z albo DT_END_ELLIPSIS lub DT_PATH_ELLIPSIS może spowodować ciąg może zostać zmodyfikowany, powodując potwierdzenia w CString zastąpić.The values DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIP, and DT_NOPREFIX cannot be used with the DT_TABSTOP value.

Wartość zwracana

Wysokość tekstu, jeśli funkcja się powiedzie.

Uwagi

Rozwijając karty do odpowiednich obszarów, wyrównywanie tekstu do lewej, prawej lub Centrum danego prostokąta, i dzielenia tekstu na wiersze, które mieszczą się w obrębie danego prostokąta go formatuje tekst.Typ formatowania jest określony przez nFormat.

Ta funkcja Członkowskie używa wybranej czcionki, kolor tekstu i kolor tła kontekstu urządzenia Rysowanie tekstu.Chyba że DT_NOCLIP format jest używany, DrawText klipów tekst tak, aby tekst nie pojawia się poza danym prostokąta.Formatowanie wszystkich zakłada, że ma wiele wierszy, chyba że DT_SINGLELINE podany jest format.

Jeśli wybrana czcionka jest zbyt duża dla określonego prostokąta DrawText Członkowskich funkcji nie próbuje zastąpić mniejszej czcionki.

Jeśli DT_CALCRECT określona flaga prostokąt określony przez lpRect zostaną zaktualizowane, aby odzwierciedlać szerokość i wysokość potrzebne do pisania tekstu.

Jeśli TA_UPDATECP została ustawiona flaga wyrównanie tekstu (zobacz CDC::SetTextAlign), DrawText tekst, począwszy od bieżącej pozycji, a nie po lewej stronie danego prostokąta.DrawTexttekst nie zostanie zawinięty, po TA_UPDATECP została ustawiona flaga (czyli DT_WORDBREAK flaga nie będą działać).

Kolor tekstu może być ustanowiony przez CDC::SetTextColor.