8.10.1.3 - Функция CreateIconFromResource

(СоздатьПиктограммуИзРесурса)

Функция CreateIconFromResource создает пиктограмму или курсор из битов ресурса, описывающих пиктограмму.

Синтаксис

HICON CreateIconFromResource
(
	PBYTE presbits,	// указатель на биты пиктограммы или курсора
	DWORD dwResSize,	// число байтов в буфере битов
	BOOL fIcon,	// флажок пиктограммы или курсора
	DWORD dwVer	// версия формата Windows
);

Параметры
presbits
Указывает на буфер, содержащий биты ресурса пиктограммы или курсора. Эти биты обычно загружаются при помощи вызова функций LookupIconIdFromDirectoryWindows 95, Вы можете также вызвать LookupIconIdFromDirectoryEx) и LoadResource.
dwResSize
Определяет размер, в байтах, набор битов, указанных параметром presbits.
fIcon
Определяет, что должно быть создано - пиктограмма или курсор. Если этот параметр - ИСТИНА (TRUE), должна быть создана пиктограмма. Если он - ЛОЖЬ (FALSE), должен быть создан курсор.
dwVer
Определяет номер версии формата пиктограммы или курсора для битов ресурса, указанных параметром presbits. Этот параметр может быть одним из следующих значений:

Формат		dwVer
Windows 2.x	0x00020000
Windows 3.x	0x00030000

Все прикладные программы, базирующиеся на Microsoft Win32, использует для пиктограмм и курсоров формат Windows 3.x.

Возвращаемые значения
Если функция завершается успешно, величина возвращаемого значения - дескриптор пиктограммы или курсора.
Если функция не выполняет задачу, величина возвращаемого значения - ПУСТО (NULL). Чтобы получать расширенные данные об ошибках, вызовите GetLastError.

Замечания
Функции CreateIconFromResource, CreateIconIndirect, GetIconInfo и LookupIconIdFromDirectory (и в Windows 95 функции CreateIconFromResourceEx и LookupIconIdFromDirectoryEx) позволяют оболочке прикладной программы и программе просмотра пиктограммы проверять и использовать ресурсы по всей системе.

Смотри также
CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfo, LoadResource, LookupIconIdFromDirectory, LookupIconIdFromDirectoryEx

Размещение и совместимость CreateIconFromResource

Windows NT				Да 
Win95					Да 
Win32s					Нет 
Импортируемая библиотека			user32.lib
Заголовочный файл				winuser.h
Уникод					Нет 
Замечания по платформе			Не имеется

Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Владимир Соковиков - 29.06.2002