CDC::DrawText

發行項
02/28/2013

呼叫此成員函式在指定矩形的格式化文字。若要指定不同的格式化選項，請使用 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_MODIFYSTRING 和 DT_END_ELLIPSIS 或 DT_PATH_ELLIPSIS 可能導致字串進行修改，造成判斷提示在 CString 覆寫。值 DT_CALCRECT、 DT_EXTERNALLEADING、 DT_INTERNAL、 DT_NOCLIP和 DT_NOPREFIX 無法搭配 DT_TABSTOP 值。

傳回值

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

備註

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

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

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

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

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

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