CDC::DrawText 

wirtualne int DrawText ( LPCTSTR lpszString, int nCount, LPRECT lpRect, UINT nFormat );

int Dr&awText (const CStringamp;strLPRECTlpRectUINTnFormat );

Wartość zwracany

Wysokość tekstu, jeśli funkcja jest pomyślne.

Parametry

lpszString

Wskazuje ciąg, który ma być rysowany. Jeśli nCount jest –1, ciąg musi być zakończona znakiem null.

nCount

Określa liczbę znaków w ciągu. Jeśli nCount jest –1, następnie lpszString zakłada się, że wskaźnik długich ciąg zakończony zerem i Begin DrawText oblicza liczbę znaków automatycznie.

lpRect

Punkty do struktury RECT lub obiektu CRect , który zawiera prostokąt (w logicznym układzie współrzędnych), w którym tekst ma zostać sformatowany.

str

 Obiekt CString , który zawiera określone znaki wyciągnąć.

nFormat

Określa metodę formatowania tekstu. Może to być dowolna kombinacja następujących wartości (łączenie za pomocą operatory operator OR):

• DT_BOTTOMnbsp;  Określa tekst wyrównany do dołu. Wartość ta musi być połączone z DT_SI&NGLELINE.
  
  
• DT_CALCRECT   Określa szerokość i wysokość prostokąta. Jeśli istnieje wiele wierszy tekstu, DrawText będzie używać szerokości prostokąta wskazywanego przez lpRect i rozszerzenie podstawy prostokąt, aby związany z ostatniego wiersza tekstu. W przypadku tylko jednego wiersza tekstu, DrawText zmodyfikuje po prawej stronie prostokąta, tak aby bounds ostatniego znaku w wierszu. W każdym z tych przypadków DrawText zwraca wysokość sformatowany tekst, ale nie wyciąga tekstu.
  
  
• DT_CE&NTERnbsp;  Wyśrodkowuje tekst poziomo.
  
  
• DT_E&ND_ELLIPSIS lub DT_PATH_ELLIPSISnbsp;Zastępuje część ciągu danego z wielokropkiem, jeśli to konieczne, tak, aby wyniki są dopasowane do określonego prostokąta. The given string nie jest modyfikowany, chyba że określono flagę DT_MODIFYSTRING.

  Można określić DT_END_ELLIPSIS celu zamienić znaki na końcu ciągu lub DT_PATH_ELLIPSIS aby zamienić znaki w środku ciągu. Jeśli ciąg zawiera odwróconej kreski ułamkowej (\), DT_PATH_ELLIPSIS zachowuje możliwie najlepiej, tekstu po ostatniej odwróconej.

• DT_EXPA&NDTABSnbsp;  Rozszerza znaki tabulacji. Domyślna liczba znaków na karcie jest osiem.
  
  
• DT_EXTER&NALLEADINGnbsp;  Zawiera czcionki zewnętrzne interlinii w wysokości wiersza. Zwykle prowadzące zewnętrznych nie jest uwzględniony w wysokości wiersza tekstu.
  
  
• DT_LEFT   Wyrównuje tekst koloru lewej.
  
  
• DT_MODIFYSTRI&NGnbsp;Modyfikuje given string odpowiadać wyświetlanego tekstu. Ta flaga jest ignorowany, chyba, że określono flagę DT_END_ELLIPSIS lub DT_PATH_ELLIPSIS.

  Uwaga Niektóre kombinacje Flaga uFormat może spowodować przekazany ciąg może być zmodyfikowany. Za pomocą DT_MODIFYSTRING z DT_END_ELLIPSIS lub DT_PATH_ELLIPSIS mogą powodować ciąg, który ma zostać zmodyfikowany, powodując potwierdzenia w CString zastąpić.

• DT_&NOCLIPnbsp;  Rysuje bez przycinania. DrawText jest nieco szybciej, gdy używany jest DT_NOCLIP.
  
  
• DT_NOPREFIXnbsp;  Wyłącza przetwarzania znaków prefiksu. Zwykle DrawText interpretuje znaków handlowego i (and) mnemonic prefiksu jako dyrektywy w celu podkreślenia znaku, który następuje i dwóch-handlowego i (& &) znaków prefiksu mnemonic jako dyrektywy wydrukować pojedynczy znak. Określając DT_NOPREFIX, przetwarzanie jest wyłączony.
  
  
• DT_PATH_ELLIPSISnbsp; & nbsp;
  
  
• DT_RIGHT   Wyrównuje tekst do koloru w prawo.
  
  
• DT_SI&NGLELINEnbsp;  Określa tylko jeden wiersz. Karetki i znaki wysuwu wiersza nie następnego wiersza.
  
  
• DT_TABSTOP   Ustawia tabulatory. Bajt wysokich numerach nFormat jest to liczba znaków dla każdej karty. Domyślna liczba znaków na karcie jest osiem.
  
  
• DT_TOP   Określa tekst wyrównany do góry (tylko w jednej linii).
  
  
• DT_VCE&NTERnbsp;  Określa tekst wyśrodkowany w pionie (tylko w jednej linii).
  
  
• DT_WORDBREAK   Określa dzielenia wyrazów. Linie są automatycznie przerwane między wyrazami, jeśli wyraz zostałyby rozszerzone w przeszłości krawędzi prostokąta określonego przez lpRect. Sekwencja return–linefeed przewozu zostaną również następnego wiersza.

&Notenbsp;Wartości DT_CALCRECT, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIPi DT_NOPREFIX nie można użyć z wartością DT_TABSTOP.

Uwagi

Wywołanie tej funkcji Państwa do formatowania tekstu w danym prostokąta. Formatuje tekst rozwijając kart do odpowiednich obszarów, wyrównywanie tekstu do lewej, prawej lub centrum danego prostokąta i podział tekstu na linie, które mieszczą się w obrębie danego prostokąta. Typ formatowania jest określany przez nFormat.

Ta funkcja Państwa używa wybranej czcionki, kolor tekstu i kolor tła kontekstu urządzenia do rysowania tekst. Jeżeli stosowany jest DT_NOCLIP format, Begin DrawText klipów tekst tak, aby tekst pojawia się poza danym prostokąta. Całe formatowanie zakłada, że ma wiele wierszy, chyba że podany jest w formacie DT_SINGLELINE.

Jeśli wybrana czcionka jest zbyt duży dla określonego prostokąta, funkcja DrawText Państwa nie próbuje mniejszej czcionki zamiennej.

Jeżeli określono flagę DT_CALCRECT , prostokąt określony przez lpRect zostaną zaktualizowane w celu odzwierciedlenia szerokość i wysokość potrzebne do rysowania tekst.

Jeśli została ustawiona flaga wyrównanie tekstu TA_UPDATECP (patrz CDC::SetTextAlign), Begin DrawText wyświetli tekst początkowy w bieżącym położeniu, a nie po lewej stronie danego prostokąta. DrawText nie zostanie zawinięty tekst, gdy została ustawiona flaga TA_UPDATECP (oznacza to, że flaga DT_WORDBREAK wywoła żadnych skutków).

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

Omówie&nie CDC |nbsp; Klasa członków | Wykres hierarchii

Zobacz teżnbsp;CDC::SetTextColor, CDC::ExtTextOut, CDC::TabbedTextOut, CDC::TextOut, :: DrawText, RECT, CDC::SetTextAlign