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