GetThemeBackgroundExtent 함수(uxtheme.h)

콘텐츠 영역에 따라 시각적 스타일로 정의된 배경의 크기와 위치를 계산합니다.

구문

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

매개 변수

[in] hTheme

형식: HTHEME

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

[in] hdc

형식: HDC

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

[in] iPartId

형식: int

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

[in] iStateId

형식: int

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

[in] pContentRect

형식: LPCRECT

논리적 좌표로 콘텐츠 배경 사각형을 포함하는 RECT 구조체에 대한 포인터입니다. 이 사각형은 GetThemeBackgroundContentRect에서 반환됩니다.

[out] pExtentRect

형식: LPRECT

논리적 좌표로 배경 사각형을 수신하는 RECT 구조체에 대한 포인터입니다. 이 사각형은 pContentRect를 기반으로합니다.

반환 값

형식: HRESULT

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

설명

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

요구 사항

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

추가 정보

GetThemeBackgroundContentRect

속성 식별자

참조