DrawTextExPrivWrap 函式
[DrawTextExPrivWrap 可透過 Windows XP 搭配 Service Pack 2 (SP2) 取得。 後續版本可能會改變或無法使用。 建議改用 DrawTextEx 。]
在指定的矩形中繪製格式化的文字。 此函式會包裝 DrawTextEx的呼叫。
語法
int WINAPI DrawTextExPrivWrap(
_In_ HDC hdc,
_Inout_ LPTSTR lpchText,
_In_ int cchText,
_Inout_ LPRECT lprc,
_In_ UINT dwDTFormat,
_In_ LPDRAWTEXTPARAMS lpDTParams
);
參數
-
hdc [in]
-
類型： HDC
要在其中繪製之裝置內容的控制碼。
-
lpchText [in， out]
-
類型： LPTSTR
緩衝區的指標，其中包含要繪製的文字。 如果 cchText 參數是 -1，字串必須以 Null 終止。
如果 dwDTFormat 包含DT_MODIFYSTRING，此函式最多可能會為此字串新增四個額外的字元。 包含字串的緩衝區應該夠大，以容納這些額外的字元。
-
cchText [in]
-
類型： int
lpchText所指向之字串的長度。 如果 cchText 是 -1，則會假設 lpchText 參數是 Null 終止字串的指標， 而 DrawTextEx 會自動計算字元計數。
-
lprc [in， out]
-
類型： LPRECT
RECT結構的指標，其中包含要格式化文字之邏輯座標中的矩形。
-
dwDTFormat [in]
-
類型： UINT
格式化選項。 如需完整的選項清單，請參閱 DrawTextEx 的檔。
-
lpDTParams [in]
-
類型： LPDRAWTEXTPARAMS
指定其他格式選項之 DRAWTEXTPARAMS 結構的指標。 此參數可以是 Null。
傳回值
類型： int
如果函式成功，則傳回值是邏輯單元中的文字高度。 如果指定DT_VCENTER或DT_BOTTOM，則傳回值會是lprc最上層成員到所繪製文字底部的位移。
如果此函式失敗，則傳回值為零。
若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
DrawTextExPrivWrap 不是依名稱匯出，也不會在公用標頭檔中宣告。 若要使用它，您必須使用 GetProcAddress ，並從 ComCtl32.dll 要求序數 416 以取得函式指標。
如需其他備註，請參閱 DrawTextEx。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2003 [僅限傳統型應用程式] |
| DLL |
|