GetThemeBitmap 함수(uxtheme.h)

  • 아티클

특정 테마, 파트, 상태 및 속성과 관련된 비트맵을 검색합니다.

구문

HRESULT GetThemeBitmap(
  [in]  HTHEME  hTheme,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  int     iPropId,
  [in]  ULONG   dwFlags,
  [out] HBITMAP *phBitmap
);

매개 변수

[in] hTheme

형식: HTHEME

테마 데이터에 대한 핸들입니다.

[in] iPartId

형식: int

비트맵을 포함하는 파트입니다. 파트 및 상태를 참조하세요.

[in] iStateId

형식: int

파트의 상태입니다.

[in] iPropId

형식: int

검색할 속성. 0을 전달하여 이 부분 및 상태에 대해 사용 가능한 첫 번째 비트맵을 자동으로 선택하거나 다음 값 중 하나를 사용합니다.

값 의미
TMT_DIBDATA
 배경 이미지입니다.
TMT_GLYPHDIBDATA
 배경 위에 그려진 문자 모양 이미지(있는 경우)입니다.
TMT_HBITMAP
 현재 지원되지 않습니다.

[in] dwFlags

형식: ULONG

비트맵을 검색하는 방법을 지정하는 플래그입니다. 다음 값 중 하나일 수 있습니다.

값 의미
GBF_DIRECT
 기존 비트맵에 대한 핸들을 검색합니다.
GBF_COPY
 비트맵의 복사본을 검색합니다.
GBF_VALIDBITS
 | GBF_DIRECTGBF_COPY

[out] phBitmap

형식: HBITMAP*

요청된 비트맵에 대한 핸들을 수신하는 포인터입니다.

반환 값

형식: HRESULT

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

설명

dwFlags가 GBF_COPY 설정된 경우 DeleteObject를 호출하여 더 이상 필요하지 않은 경우 phBitmap에 저장된 비트맵을 해제합니다.

요구 사항

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