Функция 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

Указатель на буфер Юникода, завершающийся нулевым значением, который содержит сведения о расположении загружаемого значка.

Если значение 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
Header	commctrl.h
Библиотека	Comctl32.lib
DLL	Comctl32.dll