GetThemeBackgroundContentRect 函式 (uxtheme.h)

擷取可視化樣式所定義背景的內容區域大小。

語法

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

參數

[in] hTheme

類型： HTHEME

視窗指定之主題數據的句柄。 使用 OpenThemeData 建立 HTHEME。

[in] hdc

類型： HDC

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

[in] iPartId

類型： int

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

[in] iStateId

類型： int

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

[in] pBoundingRect

類型： LPCRECT

RECT 結構的指標，其中包含邏輯座標中的總背景矩形。 這是框線或邊界內的區域。

[out] pContentRect

類型： LPRECT

在邏輯座標中接收內容區域背景矩形之 RECT 結構的指標。 此矩形會計算為符合內容區域。

傳回值

類型： HRESULT

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

備註

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

範例

將主題套用至視窗的整個工作區時，您可以呼叫 GetClientRect ，以擷取 RECT 中的這個區域，這可以透過指標當做 pContentRect 參數傳遞至 GetThemeBackgroundContentRect ，如下列範例所示。

DWORD resultFlags = GetThemeAppProperties();
bool ctrlsAreThemed = ((resultFlags & STAP_ALLOW_CONTROLS) != 0);

規格需求

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

另請參閱

GetThemeBackgroundExtent

屬性識別項

參考