Freigeben über


HitTestThemeBackground-Funktion (uxtheme.h)

Ruft einen Treffertestcode für einen Punkt im Hintergrund ab, der durch einen visuellen Stil angegeben wird.

Syntax

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

Parameter

[in] hTheme

Typ: HTHEME

Behandeln Sie die angegebenen Designdaten eines Fensters. Verwenden Sie OpenThemeData , um ein HTHEME zu erstellen.

[in] hdc

Typ: HDC

HDC, der beim Zeichnen verwendet werden soll. Dieser Parameter kann auf NULL festgelegt werden.

[in] iPartId

Typ: int

Wert des Typs int , der das Teil angibt. Weitere Informationen finden Sie unter Teile und Zustände.

[in] iStateId

Typ: int

Wert des Typs int , der den Zustand des Teils angibt. Weitere Informationen finden Sie unter Teile und Zustände.

[in] dwOptions

Typ: DWORD

DWORD , das die Treffertestoptionen angibt. Eine Liste der Optionen finden Sie unter Treffertestoptionen .

[in] pRect

Typ: LPCRECT

Zeiger auf eine RECT-Struktur , die in logischen Koordinaten das Rechteck enthält, das den Hintergrund umgrenzt.

[in] hrgn

Typ: HRGN

Handle für eine Region, die verwendet werden kann, um die Grenzen eines Treffertestbereichs anzugeben. Dieser Parameter kann auf NULL festgelegt werden.

[in] ptTest

Typ: POINT

POINT-Struktur , die die Koordinaten des Punkts enthält.

[out] pwHitTestCode

Typ: WORD*

WORD , das den Treffertestcode empfängt, der angibt, ob sich der Punkt in ptTest im Hintergrundbereich befindet, der durch pRect oder hrgn begrenzt ist. Eine Liste der zurückgegebenen Werte finden Sie unter Treffertest- Rückgabewerte .

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die Werte in ptTest und pRect sollten sich im gleichen Koordinatensystem befinden, z. B. Client oder Bildschirm. Wenn der hrgn-Parameter verwendet wird, muss er in den gleichen Koordinaten wie pRect und ptTest angegeben werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile uxtheme.h
Bibliothek UxTheme.lib
DLL UxTheme.dll

Weitere Informationen

Eigenschaftsbezeichner