HitTestThemeBackground 함수(uxtheme.h)

시각적 스타일로 지정된 배경의 지점에 대한 적중 테스트 코드를 검색합니다.

구문

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

매개 변수

[in] hTheme

형식: HTHEME

창의 지정된 테마 데이터에 대한 핸들입니다. OpenThemeData를 사용하여 HTHEME를 만듭니다.

[in] hdc

형식: HDC

그리기 시 사용할 HDC입니다. 이 매개 변수는 NULL로 설정할 수 있습니다.

[in] iPartId

형식: int

파트를 지정하는 int 형식의 값입니다. 부품 및 상태를 참조하세요.

[in] iStateId

형식: int

파트의 상태를 지정하는 int 형식의 값입니다. 부품 및 상태를 참조하세요.

[in] dwOptions

형식: DWORD

적중 테스트 옵션을 지정하는 DWORD입니다. 옵션 목록은 적중 테스트 옵션을 참조하세요.

[in] pRect

형식: LPCRECT

논리 좌표에서 배경을 경계로 하는 사각형을 포함하는 RECT 구조체에 대한 포인터입니다.

[in] hrgn

형식: HRGN

적중 테스트 영역의 범위를 지정하는 데 사용할 수 있는 영역에 대한 핸들입니다. 이 매개 변수는 NULL로 설정할 수 있습니다.

[in] ptTest

형식: POINT

점 의 좌표를 포함하는 POINT 구조체입니다.

[out] pwHitTestCode

형식: WORD*

ptTest의 지점이 pRect 또는 hrgn으로 제한된 백그라운드 영역에 있는지 여부를 나타내는 적중 테스트 코드를 수신하는 WORD입니다. 반환 된 값 목록은 적중 테스트 반환 값을 참조하세요.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

ptTest 및 pRect의 값은 클라이언트 또는 화면과 같은 동일한 좌표계에 있어야 합니다. hrgn 매개 변수를 사용하는 경우 pRect 및 ptTest와 동일한 좌표로 지정해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	uxtheme.h
라이브러리	UxTheme.lib
DLL	UxTheme.dll

추가 정보

속성 식별자