DrawThemeBackground 함수(uxtheme.h)
지정된 컨트롤 파트에 대한 시각적 스타일로 정의된 테두리 및 채우기를 그립니다.
구문
HRESULT DrawThemeBackground(
[in] HTHEME hTheme,
[in] HDC hdc,
[in] int iPartId,
[in] int iStateId,
[in] LPCRECT pRect,
[in] LPCRECT pClipRect
);
매개 변수
[in] hTheme
형식: HTHEME
창의 지정된 테마 데이터에 대한 핸들입니다. OpenThemeData를 사용하여 HTHEME를 만듭니다.
[in] hdc
형식: HDC
테마 정의 배경 이미지를 그리는 데 사용되는 HDC입니다.
[in] iPartId
형식: int
그릴 부분을 지정하는 int 형식의 값입니다. 부품 및 상태를 참조하세요.
[in] iStateId
형식: int
그릴 파트의 상태를 지정하는 int 형식의 값입니다. 부품 및 상태를 참조하세요.
[in] pRect
형식: const RECT*
사각형이 포함된 RECT 구조체에 대한 포인터로, 논리 좌표로 배경 이미지가 그려집니다.
[in] pClipRect
형식: const RECT*
클리핑 사각형을 포함하는 RECT 구조체에 대한 포인터입니다. 이 매개 변수는 NULL로 설정할 수 있습니다.
반환 값
형식: HRESULT
이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
그리기 작업은 pRect에 지정된 사각형을 초과하지 않고 맞게 크기가 조정됩니다. 애플리케이션이 pClipRect로 지정된 사각형 외부에 그리면 안 됩니다.
예제
창의 배경 이미지를 그리기 위해 DrawThemeBackground 를 호출하기 전에 IsThemeBackgroundPartiallyTransparent를 호출할 수 있습니다. 이 메서드는 부분적으로 투명하거나 알파 혼합된 자식 컨트롤 뒤에 배경을 그리기 위해 DrawThemeParentBackground 를 호출해야 하는지 여부를 결정하고 다음 예제에서 설명합니다.
if (_hTheme)
{
if (IsThemeBackgroundPartiallyTransparent(_hTheme, BP_PUSHBUTTON, _iStateId))
{
DrawThemeParentBackground(_hwnd, hdcPaint, prcPaint);
}
DrawThemeBackground(_hTheme,
hdcPaint,
BP_PUSHBUTTON,
_iStateId,
&rcClient,
prcPaint);
}
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | uxtheme.h |
| 라이브러리 | UxTheme.lib |
| DLL | UxTheme.dll |