DrawThemeTextEx 函式 (uxtheme.h)

使用視覺化樣式所定義的色彩和字型繪製文字。 藉由允許其他文字格式選項來擴充 DrawThemeText 。

語法

HRESULT DrawThemeTextEx(
  [in]      HTHEME        hTheme,
  [in]      HDC           hdc,
  [in]      int           iPartId,
  [in]      int           iStateId,
  [in]      LPCWSTR       pszText,
  [in]      int           cchText,
  [in]      DWORD         dwTextFlags,
  [in, out] LPRECT        pRect,
  [in]      const DTTOPTS *pOptions
);

參數

[in] hTheme

類型： HTHEME

視窗指定之主題資料的控制碼。 使用 OpenThemeData 建立 HTHEME。

[in] hdc

類型： HDC

要用於繪製的 HDC。

[in] iPartId

類型： int

具有想要的文字外觀之控制項組件。 請參閱 元件和狀態。 如果此值為 0，則會使用預設字型來繪製文字；否則會使用裝置內容中所選取的字型。

[in] iStateId

類型： int

具有想要的文字外觀的控制項狀態。 請參閱 元件和狀態。

[in] pszText

類型： LPCWSTR

字串的指標，其中包含要繪製的文字。

[in] cchText

類型： int

int類型的值，其中包含要繪製的字元數。 如果參數設定為 -1，則會繪製字串中的所有字元。

[in] dwTextFlags

類型： DWORD

包含指定字串格式設定之一或多個值的DWORD。 如需可能的參數值 ，請參閱格式 值。

[in, out] pRect

類型： LPRECT

RECT結構的指標，其中包含要繪製文字的邏輯座標矩形。

[in] pOptions

類型：const DTTOPTS*

DTTOPTS結構，定義將套用至所繪製文字的其他格式設定選項。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

如果已定義主題字型，函式一律會針對指定的部分和狀態使用主題字型。 否則，它會使用目前在裝置內容中選取的字型。 若要瞭解是否已定義主題字型，您可以呼叫 GetThemeFont 或 GetThemePropertyOrigin ，並將 TMT_FONT 作為屬性識別碼。

需求

最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	uxtheme.h
程式庫	UxTheme.lib
Dll	UxTheme.dll