ExtTextOutWrap 函式

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

使用目前選取的字型、背景色彩和文字色彩繪製文字。 您可以選擇性地提供要用於裁剪、不透明度或兩者的維度。 此函式會包裝 對 ExtTextOut的呼叫。

語法

BOOL ExtTextOutWrap(
  _In_       HDC     hdc,
  _In_       int     X,
  _In_       int     Y,
  _In_       UINT    uOptions,
  _In_ const RECT    *lprc,
  _In_       LPCTSTR lpString,
  _In_       UINT    cbCount,
  _In_ const INT     *lpDx
);

參數

hdc [in]

類型： HDC

裝置內容的控制碼。

X [in]

類型： int

用來放置字串之參考點的 x 座標，以邏輯座標表示。

Y [in]

類型： int

用來放置字串之參考點的 Y 座標，以邏輯座標表示。

uOptions [in]

類型： UINT

指定如何使用應用程式定義矩形的值。 如需選項的完整清單，請參閱 ExtTextOut 。

lprc [in]

類型：const RECT*

選擇性 RECT 結構的指標，指定用於裁剪、不透明度或兩者之矩形的維度，以邏輯座標表示。

lpString [in]

類型： LPCTSTR

緩衝區的指標，其中包含要繪製的文字。 字串不需要以零結尾，因為 cbCount 會指定字串的長度。

cbCount [in]

類型： UINT

字串的長度，以位元組為單位，由 lpString指向。

lpDx [in]

類型：const INT*

值的選擇性陣列指標，表示相鄰字元儲存格的原點之間的距離。 例如， lpDx[x] 邏輯單元會分隔字元儲存格 x 和字元儲存格的原點， (x + 1) 。

傳回值

類型： BOOL

如果成功繪製字串，則傳回非零值。 不過，如果使用 ETO_GLYPH_INDEX 呼叫 ExtTextOut 的 ANSI 版本，即使函式沒有執行任何動作，函式仍會傳回 TRUE 。

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

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

備註

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

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

規格需求