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。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2003 [僅限桌面應用程式] |
| DLL |
|