LoadIconWithScaleDown 함수(commctrl.h)

아이콘을 로드합니다. 아이콘이 표준 크기가 아닌 경우 이 함수는 작은 이미지를 확대하는 대신 큰 이미지의 크기를 조정합니다.

구문

HRESULT LoadIconWithScaleDown(
  [in]  HINSTANCE hinst,
  [in]  PCWSTR    pszName,
  [in]  int       cx,
  [in]  int       cy,
  [out] HICON     *phico
);

매개 변수

[in] hinst

형식: HINSTANCE

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

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

[in] pszName

형식: PCWSTR

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

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

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

[in] cx

형식: int

아이콘의 원하는 너비(픽셀)입니다.

[in] cy

형식: int

아이콘의 원하는 높이(픽셀)입니다.

[out] phico

형식: HICON*

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

반환 값

형식: HRESULT

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

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

설명

이 함수는 먼저 아이콘 파일에서 정확히 동일한 크기의 아이콘을 검색합니다. 일치하는 항목을 찾을 수 없는 경우 cx 와 cy 가 표준 아이콘 크기(16, 32, 48 또는 256픽셀) 중 하나와 일치하지 않는 한 다음 가장 큰 아이콘이 선택되고 원하는 크기로 축소됩니다. 예를 들어 호출 애플리케이션에서 x 차원 40픽셀의 아이콘을 요청하는 경우 48픽셀 아이콘이 사용되고 40픽셀로 축소됩니다. 반면 LoadImage 함수는 32픽셀 아이콘을 선택하고 최대 40픽셀까지 확장합니다.

함수가 더 큰 아이콘을 찾을 수 없는 경우 다음으로 작은 아이콘을 찾아 원하는 크기로 확장하는 표준 동작으로 기본 설정됩니다.

요구 사항

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