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 |
|