DrawTextWrap 函式

[DrawTextWrap 可透過 Windows XP 搭配 Service Pack 2 (SP2) 取得。 後續版本可能會變更或無法使用。 建議改為直接使用 DrawText 。]

在指定的矩形中繪製格式化的文字。 它會根據指定的方法格式化文字， (展開索引標籤、對齊字元、斷行等) 。 此函式會包裝 對 DrawText的呼叫。

語法

int WINAPI DrawTextWrap(
  _In_    HDC              hdc,
  _Inout_ LPCTSTR          lpString,
  _In_    int              nCount,
  _Inout_ LPRECT           lpRect,
  _In_    UINT             uFormat,
  _In_    LPDRAWTEXTPARAMS lpDTParams
);

參數

hdc [in]

類型： HDC

裝置內容的控制碼。

lpString [in， out]

類型： LPCTSTR

緩衝區的指標，其中包含要繪製的文字。 如果 nCount 參數為 -1，字串必須以 Null 終止。

如果 uFormat 包含DT_MODIFYSTRING，此函式最多可能會為此字串新增四個額外的字元。 包含字串的緩衝區應該夠大，以容納這些額外的字元。

nCount [in]

類型： int

lpString所指向的字串長度。 如果 nCount 為 -1，則會假設 lpString 參數是 Null 終止字串的指標， 而 DrawText 會自動計算字元計數。

lpRect [in， out]

類型： LPRECT

RECT結構的指標，其中包含要格式化文字的邏輯座標矩形。

uFormat [in]

類型： UINT

格式化選項。 如需選項的完整清單，請參閱 DrawText 的檔。

lpDTParams [in]

類型： LPDRAWTEXTPARAMS

DRAWTEXTPARAMS結構的指標，指定其他格式選項。 此參數可以是 Null。

傳回值

類型： int

如果函式成功，則傳回值會是邏輯單元中的文字高度。 如果指定DT_VCENTER或DT_BOTTOM，則傳回值會是從 lprc頂端成員到繪製文字底部的位移。如果函式失敗，則傳回值為零。

如果此函式失敗，則傳回值為零。

若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

DrawTextWrap 不會依名稱匯出或在公用標頭中宣告。 若要使用它，您必須使用 GetProcAddress ，並從ComCtl32.dll要求序數 415 以取得函式指標。

如需其他備註，請參閱 DrawText。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
DLL	Comctl32.dll (6.0 版或更新版本)