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
Comctl32.dll (6.0 版或更新版本)