共用方式為


CDC::DrawText

呼叫此成員函式在指定矩形的格式化文字。 若要指定不同的格式化選項,請使用 CDC::DrawTextEx

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

參數

  • lpszString
    要繪製的字串的點。 如果 nCount –必須是 null 結尾 1,字串。

  • nCount
    字串中指定的字元數目。 如果 nCount 為– 1,則 lpszString 假設是長指標以 null 結尾的字串,並 DrawText 自動計算字元計數。

  • lpRect
    的長度 的點建構或包含矩形的 CRect 物件 (以邏輯座標) 文字要格式化。

  • str
    包含要繪製的指定字元的 CString 物件。

  • nFormat
    指定格式化文字的方法。 它可以是 uFormat 參數所描述之值的任何組合。 DrawText 在 Windows SDK。 (使用位元的 OR 運算子組合):

    注意事項注意事項

    陣列 uFormat 旗標組合可能造成傳遞的字串進行修改。使用 DT_MODIFYSTRINGDT_END_ELLIPSISDT_PATH_ELLIPSIS 可能導致字串進行修改,造成判斷提示在 CString 覆寫。值 DT_CALCRECTDT_EXTERNALLEADINGDT_INTERNALDT_NOCLIPDT_NOPREFIX 無法搭配 DT_TABSTOP 值。

傳回值

文字的高度,如果函式進行。

備註

它會展開定位點格式化文字放入適當的空間,將文字靠正確,或指定矩形左側的中心和中斷文字輸入行在指定矩形內的符合。 格式化的型別。 nFormat指定。

此成員函式使用裝置内容的選取文字的字型、色彩和背景色彩來繪製文字。 除非使用 DT_NOCLIP 格式, DrawText 裁剪文字,讓文字未出現在指定的矩形。 除非提供,會假設所有格式都具有多行 DT_SINGLELINE 格式。

如果選取的字型對於指定的矩形而言太大, DrawText 成員函式不會嘗試替換較小的字型。

如果 DT_CALCRECT 旗標,指定 lpRect 指定矩形會更新以反映必要的寬度和高度來繪製文字。

如果 TA_UPDATECP 文字對齊設定旗標 (請參閱), CDC::SetTextAlignDrawText 將顯示 (從目前位置的文字,而不是在指定矩形的左邊。 DrawText 不會自動換行的文字,並且 TA_UPDATECP 旗標設定 (也就 DT_WORDBREAK 旗標不會有任何作用)。

文字色彩可能會 CDC::SetTextColor設定。

需求

Header: afxwin.h

請參閱

參考

CDC 類別

階層架構圖

CDC::SetTextColor

CDC::ExtTextOut

CDC::TabbedTextOut

CDC::TextOut

DrawText

RECT 結構

CDC::SetTextAlign