HitTestThemeBackground, fonction (uxtheme.h)

Article
03/03/2024

Récupère un code de test de positionnement pour un point en arrière-plan spécifié par un style visuel.

Syntaxe

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
);

Paramètres

[in] hTheme

Type : HTHEME

Gérez les données de thème spécifiées d’une fenêtre. Utilisez OpenThemeData pour créer un HTHEME.

[in] hdc

Type : HDC

HDC à utiliser lors du dessin. Ce paramètre peut être défini sur NULL.

[in] iPartId

Type : int

Valeur de type int qui spécifie la partie. Consultez Parties et états.

[in] iStateId

Type : int

Valeur de type int qui spécifie l’état du composant. Consultez Parties et états.

[in] dwOptions

Type : DWORD

DWORD qui spécifie les options de test de positionnement. Pour obtenir la liste des options, consultez Options de test de positionnement.

[in] pRect

Type : LPCRECT

Pointeur vers une structure RECT qui contient, en coordonnées logiques, le rectangle qui lie l’arrière-plan.

[in] hrgn

Type : HRGN

Gérez vers une région qui peut être utilisée pour spécifier les limites d’une zone de test de positionnement. Ce paramètre peut être défini sur NULL.

[in] ptTest

Type : POINT

STRUCTURE POINT qui contient les coordonnées du point.

[out] pwHitTestCode

Type : WORD*

WORD qui reçoit le code de test de positionnement qui indique si le point dans ptTest se trouve dans la zone d’arrière-plan limitée par pRect ou hrgn. Consultez Valeurs de retour du test de positionnement pour obtenir la liste des valeurs retournées.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Les valeurs dans ptTest et pRect doivent se trouver dans le même système de coordonnées, tel que client ou écran. Si le paramètre hrgn est utilisé, il doit être spécifié dans les mêmes coordonnées que pRect et ptTest.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uxtheme.h
Bibliothèque	UxTheme.lib
DLL	UxTheme.dll

Voir aussi

Identificateurs de propriété

Partager via