CopyImage

CopyImage функція створює нове зображення (значок, курсор або бітового) і копіює атрибути зображення, вказаний на нову. Якщо необхідно, функція тягнеться біти до бажаного розміру зображення нового.

( CopyImage РУЧКУ Ручка  hImage, / / ручка на зображення, щоб скопіюватиUINTuType, / / тип зображення для копіюванняIntcxDesired, / / бажане ширина нове зображенняIntcyDesired, / / бажане висоту нового зображенняUINTfuFlags / / скопіювати прапори);

Параметри

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.

Зауваження

Після завершення використання ресурсу, ви можете звільнити свого пов'язаних пам'яті за номером один функцій в таблиці.

Ресурс	Реліз функції
Крапковий малюнок	Видалити за допомогою
Курсор	DestroyCursor
Значок	DestroyIcon

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

QuickInfo

nbsp; Windows &NT: потрібна Версія 3.5 або пізнішу версію.
Windows:Вимагає Windows 95 або пізнішої версії.
Windows CE:Не підтримується.
Заголовка:Оголошена в winuser.h.
Імпортувати бібліотеки:Використання user32.lib.

Дивіться також

Огляд ресурсів, ресурс функції, LoadImage

Index