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 형식의 값입니다. 다음 값 중 하나일 수 있습니다.
값 | 의미 |
---|---|
|
DrawThemeIcon에 사용되는 알파 값(0~255)입니다. |
|
픽셀을 불투명으로 간주해야 하는 최소 알파 값(0-255)입니다. |
|
이 파트가 테두리 채우기를 사용하는 경우 그려지는 테두리의 두께입니다. |
|
파트가 글꼴 기반 문자 모양을 사용하는 경우 문자 모양에 사용될 선택된 글꼴의 문자 인덱스입니다. |
|
파트를 그리는 데 사용할 첫 번째 그라데이션 색의 양입니다. 이 값은 0에서 255 사이일 수 있지만 이 값에 각 GRADIENTRATIO 값을 더하면 최대 255가 되어야 합니다. GetThemeColor의 TMT_GRADIENTCOLOR1 값을 참조하세요. |
|
파트를 그리는 데 사용할 두 번째 그라데이션 색의 양입니다. |
|
파트를 그리는 데 사용할 세 번째 그라데이션 색의 양입니다. |
|
파트를 그리는 데 사용할 네 번째 그라데이션 색의 양입니다. |
|
파트를 그리는 데 사용할 다섯 번째 그라데이션 색의 양입니다. |
|
파트의 높이입니다. |
|
이미지 파일에 있는 상태 이미지의 수입니다. |
|
첫 번째 이미지 파일이 디자인된 최소 dpi입니다. GetThemeFilename을 참조하세요. |
|
두 번째 이미지 파일이 설계된 최소 dpi입니다. |
|
세 번째 이미지 파일이 설계된 최소 dpi입니다. |
|
네 번째 이미지 파일이 설계된 최소 dpi입니다. |
|
다섯 번째 이미지 파일이 설계된 최소 dpi입니다. |
|
작업이 얼마나 진행되었는지 정의하는 진행률 컨트롤 "청크" 모양의 크기입니다. |
|
모든 진행률 컨트롤 "청크"의 총 크기입니다. |
|
부품 모서리의 둥글기(0-100%)입니다. |
|
부품 모서리의 둥글기(0-100%)입니다. |
|
DrawThemeIcon을 사용하여 그린 아이콘에 적용할 채도의 양(0~255)입니다. |
|
텍스트 문자 주위에 그려지는 테두리의 두께입니다. |
|
이미지가 늘어나는 실제 크기 이미지의 원래 크기 비율입니다. |
|
파트의 너비입니다. |
[out] piVal
형식: int*
메트릭 속성 값을 받는 int에 대한 포인터입니다.
반환 값
형식: HRESULT
이 함수가 성공하면 S_OK 반환합니다. 성공하지 않으면 HRESULT 오류 코드를 반환합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | uxtheme.h |
라이브러리 | UxTheme.lib |
DLL | UxTheme.dll |