CopyImage

Функция CopyImage создает новое изображение (значок, курсор или растровых) и копирует атрибуты указанного изображения на новый. При необходимости, функция простирается биты под требуемый размер нового изображения.

Ручка CopyImage) ОБРАБАТЫВАТЬ  hImage, / / обработать изображение для копированияUINTuType, / / тип изображения для копированияintcxDesired, / / желаемой ширине нового изображенияintcyDesired, / / желаемая Высота нового изображенияUINTfuFlags / / copy флаги);
 

Параметры

hinst
Дескриптор экземпляра модуля, содержащего изображение для копирования.
uType
Указывает тип изображения для копирования. Этот параметр может принимать одно из следующих значений:
Значение Значение
IMAGE_BITMAP Копирует растровое изображение.
IMAGE_CURSOR Копирует курсора.
IMAGE_ICON Копирование значка.

cxDesired
Определяет требуемую ширину в пикселах изображения.
cyDesired
Определяет необходимую высоту в пикселах изображения.
fuFlags
Определяет комбинацию следующих значений:
Значение Значение
LR_COPYDELETEORG После создания копии удаляет исходное изображение.
LR_COPYRETURNORG Создает точную копию изображения, игнорируя параметров cxDesired и cyDesired.
LR_MONOCHROME Создает новое монохромное изображение.
LR_COPYFROMRESOURCE Пытается загрузить ресурс значка или курсора из исходного файла ресурсов, а не простое копирование текущего изображения. Это полезно для создания копии различных размеров, когда файл ресурсов содержит несколько размеров ресурса. Без этого флага CopyImage простирается исходное изображение новым размером. Если этот флаг установлен, CopyImage использует размер в файле ресурсов, ближе всего к нужного размера.

Это будет успешной, только если hImage был загружен LoadIcon или LoadCursor, или LoadImage с флагом LR_SHARED.


Возвращаемые значения

Если функция выполнена успешно, возвращаемое значение является дескриптор вновь созданного образа.

Если вызов функции был неуспешен, возвращается значение NULL. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Примечания

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

Ресурс Функция выпуска
Точечный рисунок DeleteObject
Курсор DestroyCursor
Значок DestroyIcon

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

QuickInfo

nbsp; Windows &NT: требует версии 3.5 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Не поддерживается.
Заголовок:Объявленные в winuser.h.
Импорта библиотеки:Использование user32.lib.

Родственные слова

Обзор ресурсов, функций ресурсов, LoadImage

Index