Funzione GetThemeBackgroundContentRect (uxtheme.h)

Recupera le dimensioni dell'area del contenuto per lo sfondo definito dallo stile visivo.

Sintassi

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

Parametri

[in] hTheme

Tipo: HTHEME

Gestire i dati del tema specificati di una finestra. Usare OpenThemeData per creare un HTHEME.

[in] hdc

Tipo: HDC

HDC da usare durante il disegno. Questo parametro può essere impostato su NULL.

[in] iPartId

Tipo: int

Valore di tipo int che specifica la parte che contiene l'area del contenuto. Vedere Parti e Stati.

[in] iStateId

Tipo: int

Valore di tipo int che specifica lo stato della parte che contiene l'area contenuto. Vedere Parti e Stati.

[in] pBoundingRect

Tipo: LPCRECT

Puntatore a una struttura RECT che contiene il rettangolo di sfondo totale, nelle coordinate logiche. Si tratta dell'area all'interno dei bordi o dei margini.

[out] pContentRect

Tipo: LPRECT

Puntatore a una struttura RECT che riceve il rettangolo di sfondo dell'area del contenuto, nelle coordinate logiche. Questo rettangolo viene calcolato per adattare l'area del contenuto.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Uno stile visivo può definire un'area contenuto all'interno di ogni immagine di sfondo. Si tratta dell'area in cui il contenuto, ad esempio testo e icone, può essere posizionato senza sovrascrivere i bordi di sfondo.

Esempio

Quando si applica un tema a un'intera area client di una finestra, è possibile chiamare GetClientRect per recuperare questa area in un reCT, che può essere passato tramite puntatore come parametro pContentRect a GetThemeBackgroundContentRect come nell'esempio seguente.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uxtheme.h
Libreria	UxTheme.lib
DLL	UxTheme.dll

Vedi anche

GetThemeBackgroundExtent

Identificatori di proprietà

Riferimento