GetThemeBackgroundExtent 函式 (uxtheme.h)

根據內容區域，計算由視覺化樣式定義的背景大小和位置。

語法

HRESULT GetThemeBackgroundExtent(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  LPCRECT pContentRect,
  [out] LPRECT  pExtentRect
);

參數

[in] hTheme

類型： HTHEME

處理視窗的指定主題資料。 使用 OpenThemeData 建立 HTHEME。

[in] hdc

類型： HDC

繪製時要使用的 HDC。 此參數可以設定為 Null。

[in] iPartId

類型： int

int類型的值，指定包含內容的元件。 請參閱 元件和狀態。

[in] iStateId

類型： int

int類型的值，指定包含內容的元件狀態。 請參閱 元件和狀態。

[in] pContentRect

類型： LPCRECT

RECT結構的指標，其中包含邏輯座標中的內容背景矩形。 此矩形會從 GetThemeBackgroundContentRect傳回。

[out] pExtentRect

類型： LPRECT

在邏輯座標中接收背景矩形之 RECT 結構的指標。 此矩形是以 pContentRect為基礎。

傳回值

類型： HRESULT

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

備註

主題可以在每個背景影像內定義內容區域。 這是可在不覆寫背景框線的情況下放置文字和圖示等內容的區域。

規格需求

另請參閱

GetThemeBackgroundContentRect

屬性識別項

參考