다음을 통해 공유

GetThemeMetric 함수(uxtheme.h)

  • 아티클

메트릭 속성의 값을 검색합니다.

구문

HRESULT GetThemeMetric(
  [in]  HTHEME hTheme,
  [in]  HDC    hdc,
  [in]  int    iPartId,
  [in]  int    iStateId,
  [in]  int    iPropId,
  [out] int    *piVal
);

매개 변수

[in] hTheme

형식: HTHEME

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

[in] hdc

형식: HDC

Hdc. 이 매개 변수는 NULL로 설정할 수 있습니다.

[in] iPartId

형식: int

메트릭 속성을 포함하는 부분을 지정하는 int 형식의 값입니다. 파트 및 상태를 참조하세요.

[in] iStateId

형식: int

파트의 상태를 지정하는 int 형식의 값입니다. 파트 및 상태를 참조하세요.

[in] iPropId

형식: int

검색할 속성을 지정하는 int 형식의 값입니다. 다음 값 중 하나일 수 있습니다.

값 의미
TMT_ALPHALEVEL
 DrawThemeIcon에 사용되는 알파 값(0~255)입니다.
TMT_ALPHATHRESHOLD
 픽셀을 불투명으로 간주해야 하는 최소 알파 값(0-255)입니다.
TMT_BORDERSIZE
 이 파트가 테두리 채우기를 사용하는 경우 그려지는 테두리의 두께입니다.
TMT_GLYPHINDEX
 파트가 글꼴 기반 문자 모양을 사용하는 경우 문자 모양에 사용될 선택된 글꼴의 문자 인덱스입니다.
TMT_GRADIENTRATIO1
 파트를 그리는 데 사용할 첫 번째 그라데이션 색의 양입니다. 이 값은 0에서 255 사이일 수 있지만 이 값에 각 GRADIENTRATIO 값을 더하면 최대 255가 되어야 합니다. GetThemeColor의 TMT_GRADIENTCOLOR1 값을 참조하세요.
TMT_GRADIENTRATIO2
 파트를 그리는 데 사용할 두 번째 그라데이션 색의 양입니다.
TMT_GRADIENTRATIO3
 파트를 그리는 데 사용할 세 번째 그라데이션 색의 양입니다.
TMT_GRADIENTRATIO4
 파트를 그리는 데 사용할 네 번째 그라데이션 색의 양입니다.
TMT_GRADIENTRATIO5
 파트를 그리는 데 사용할 다섯 번째 그라데이션 색의 양입니다.
TMT_HEIGHT
 파트의 높이입니다.
TMT_IMAGECOUNT
 이미지 파일에 있는 상태 이미지의 수입니다.
TMT_MINDPI1
 첫 번째 이미지 파일이 디자인된 최소 dpi입니다. GetThemeFilename을 참조하세요.
TMT_MINDPI2
 두 번째 이미지 파일이 설계된 최소 dpi입니다.
TMT_MINDPI3
 세 번째 이미지 파일이 설계된 최소 dpi입니다.
TMT_MINDPI4
 네 번째 이미지 파일이 설계된 최소 dpi입니다.
TMT_MINDPI5
 다섯 번째 이미지 파일이 설계된 최소 dpi입니다.
TMT_PROGRESSCHUNKSIZE
 작업이 얼마나 진행되었는지 정의하는 진행률 컨트롤 "청크" 모양의 크기입니다.
TMT_PROGRESSSPACESIZE
 모든 진행률 컨트롤 "청크"의 총 크기입니다.
TMT_ROUNDCORNERWIDTH
 부품 모서리의 둥글기(0-100%)입니다.
TMT_ROUNDCORNERHEIGHT
 부품 모서리의 둥글기(0-100%)입니다.
TMT_SATURATION
 DrawThemeIcon을 사용하여 그린 아이콘에 적용할 채도의 양(0~255)입니다.
TMT_TEXTBORDERSIZE
 텍스트 문자 주위에 그려지는 테두리의 두께입니다.
TMT_TRUESIZESTRETCHMARK
 이미지가 늘어나는 실제 크기 이미지의 원래 크기 비율입니다.
TMT_WIDTH
 파트의 너비입니다.

[out] piVal

형식: int*

메트릭 속성 값을 받는 int에 대한 포인터입니다.

반환 값

형식: HRESULT

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

요구 사항

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

추가 정보

속성 식별자