Funzione HitTestThemeBackground (uxtheme.h)

Articolo
03/03/2024

Recupera un codice di hit test per un punto in background specificato da uno stile di visualizzazione.

Sintassi

HRESULT HitTestThemeBackground(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  DWORD   dwOptions,
  [in]  LPCRECT pRect,
  [in]  HRGN    hrgn,
  [in]  POINT   ptTest,
  [out] WORD    *pwHitTestCode
);

Parametri

[in] hTheme

Tipo: HTHEME

Handle per 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. Vedere Parti e stati.

[in] iStateId

Tipo: int

Valore di tipo int che specifica lo stato della parte. Vedere Parti e stati.

[in] dwOptions

Tipo: DWORD

DWORD che specifica le opzioni di hit test. Per un elenco di opzioni, vedere Opzioni hit test .

[in] pRect

Tipo: LPCRECT

Puntatore a una struttura RECT che contiene, in coordinate logiche, il rettangolo che delimita lo sfondo.

[in] hrgn

Tipo: HRGN

Handle in un'area che può essere usata per specificare i limiti di un'area di hit test. Questo parametro può essere impostato su NULL.

[in] ptTest

Tipo: POINT

Struttura POINT che contiene le coordinate del punto.

[out] pwHitTestCode

Tipo: WORD*

WORD che riceve il codice di hit test che indica se il punto in ptTest si trova nell'area di sfondo delimitata da pRect o hrgn. Per un elenco di valori restituiti, vedere Valori restituiti dall'hit test .

Valore restituito

Tipo: HRESULT

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

Commenti

I valori in ptTest e pRect devono trovarsi nello stesso sistema di coordinate, ad esempio client o schermo. Se viene usato il parametro hrgn , deve essere specificato nelle stesse coordinate di pRect e ptTest.

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

Identificatori di proprietà

Condividi tramite