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 |