다음을 통해 공유

LoadIconMetric 함수(commctrl.h)

  • 아티클

클라이언트 지정 시스템 메트릭을 사용하여 지정된 아이콘 리소스를 로드합니다.

구문

HRESULT LoadIconMetric(
  [in]  HINSTANCE hinst,
  [in]  PCWSTR    pszName,
  [in]  int       lims,
  [out] HICON     *phico
);

매개 변수

[in] hinst

형식: HINSTANCE

로드할 아이콘이 포함된 DLL 또는 실행 파일(.exe) 파일의 모듈에 대한 핸들입니다. 자세한 내용은 GetModuleHandle을 참조하세요.

미리 정의된 시스템 아이콘 또는 독립 실행형 아이콘 파일을 로드하려면 이 매개 변수를 NULL로 설정합니다.

[in] pszName

형식: PCWSTR

로드할 아이콘에 대한 위치 정보가 포함된 null로 끝나는 유니코드 버퍼에 대한 포인터입니다.

hinst가 NULL이 아닌 경우 pszName은 이름 또는 서수로 아이콘 리소스를 지정합니다. 이 서수는 MAKEINTRESOURCE 매크로를 사용하여 패키지해야 합니다.

hinst가 NULL인 경우 pszName은 로드할 미리 정의된 시스템 아이콘의 식별자(IDI_ 접두사부터 시작)를 지정합니다.

[in] lims

형식: int

원하는 메트릭입니다. 다음 값 중 하나입니다.

값 의미
LIM_SMALL
 작은 아이콘의 권장 픽셀 너비인 SM_CXSMICON 해당합니다.
LIM_LARGE
 아이콘의 기본 픽셀 너비인 SM_CXICON 해당합니다.

[out] phico

형식: HICON*

이 함수가 반환될 때 로드된 아이콘의 핸들에 대한 포인터를 포함합니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 다음 값을 포함하여 오류를 반환합니다.

반환 코드 설명
E_INVALIDARG
 pszName이 가리키는 버퍼의 내용이 예상되는 해석에 맞지 않습니다.

설명

LoadIconMetric 은 LoadIcon과 비슷하지만 아이콘 메트릭을 지정하는 기능이 있습니다. 호출 애플리케이션이 고품질 아이콘을 보장하려고 할 때 LoadIcon 대신 사용됩니다. 이는 dpi(인치당 높은 점) 상황에서 특히 유용합니다.

아이콘은 다음과 같이 추출되거나 만들어집니다.

  1. 리소스에서 정확한 크기 일치 항목이 발견되면 해당 아이콘이 사용됩니다.
  2. 정확한 크기 일치를 찾을 수 없고 더 큰 아이콘을 사용할 수 있는 경우 더 큰 버전을 원하는 크기로 스케일 다운하여 새 아이콘이 만들어집니다.
  3. 정확한 크기 일치를 찾을 수 없고 더 큰 아이콘을 사용할 수 없는 경우 더 작은 아이콘을 원하는 크기로 확장하여 새 아이콘을 만듭니다.
LoadIconMetric 및 LoadIcon에 대한 비교 호출은 여기에 표시됩니다. 
NOTIFYICONDATA  nidIconData  = {0};
nidIconData.hIcon = LoadIcon(hInstance, MAKEINTRESOURCE(IDI_ICON));

// Or...

HRESULT hr = LoadIconMetric(hInstance, MAKEINTRESOURCE(IDI_ICON), LIM_SMALL, &nidIconData.hIcon);

애플리케이션은 검색된 아이콘에서 DestroyIcon 을 호출합니다.

요구 사항

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