DrawTextExPrivWrap 函式

[DrawTextExPrivWrap可透過 Service Pack 2 Windows XP (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_VCENTERDT_BOTTOM,則傳回值會是lprc最上層成員到所繪製文字底部的位移。

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

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

備註

DrawTextExPrivWrap 不是依名稱匯出,也不會在公用標頭檔中宣告。 若要使用它,您必須使用 GetProcAddress ,並從 ComCtl32.dll 要求序數 416 以取得函式指標。

如需其他備註,請參閱 DrawTextEx

規格需求

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