GetThemeBackgroundContentRect 함수(uxtheme.h)

시각적 스타일로 정의된 배경에 대한 콘텐츠 영역의 크기를 검색합니다.

구문

HRESULT GetThemeBackgroundContentRect(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  LPCRECT pBoundingRect,
  [out] LPRECT  pContentRect
);

매개 변수

[in] hTheme

형식: HTHEME

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

[in] hdc

형식: HDC

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

[in] iPartId

형식: int

콘텐츠 영역이 포함된 부분을 지정하는 int 형식의 값입니다. 부품 및 상태를 참조하세요.

[in] iStateId

형식: int

콘텐츠 영역이 포함된 파트의 상태를 지정하는 int 형식의 값입니다. 부품 및 상태를 참조하세요.

[in] pBoundingRect

형식: LPCRECT

논리적 좌표로 총 배경 사각형을 포함하는 RECT 구조체에 대한 포인터입니다. 테두리 또는 여백 내의 영역입니다.

[out] pContentRect

형식: LPRECT

논리적 좌표로 콘텐츠 영역 배경 사각형을 수신하는 RECT 구조체에 대한 포인터입니다. 이 사각형은 콘텐츠 영역에 맞게 계산됩니다.

반환 값

형식: HRESULT

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

설명

비주얼 스타일은 각 배경 이미지 내에서 콘텐츠 영역을 정의할 수 있습니다. 배경 테두리를 덮어쓰지 않고 텍스트 및 아이콘과 같은 콘텐츠를 배치할 수 있는 영역입니다.

예제

창의 전체 클라이언트 영역에 테마를 적용할 때 GetClientRect를 호출하여 RECT에서 이 영역을 검색할 수 있습니다. 이 영역은 다음 예제와 같이 포인터를 통해 getThemeBackgroundContentRect에 pContentRect 매개 변수로 전달될 수 있습니다.

DWORD resultFlags = GetThemeAppProperties();
bool ctrlsAreThemed = ((resultFlags & STAP_ALLOW_CONTROLS) != 0);

요구 사항

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

추가 정보

GetThemeBackgroundExtent

속성 식별자

참조