다음을 통해 공유


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

추가 정보

속성 식별자