CBitmap::LoadBitmap

Загружает ресурс растрового изображения или lpszResourceName с именем заданного по идентификатору в nIDResource из исполняемого файла приложения.

BOOL LoadBitmap(
   LPCTSTR lpszResourceName 
);
BOOL LoadBitmap(
   UINT nIDResource 
);

Параметры

  • lpszResourceName
    Указывает на null- завершенной строку, содержащую имя ресурса растрового изображения.

  • nIDResource
    Указывает идентификатор ресурса (uri ресурса растрового изображения.

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

Ненулевой, если успешно; в противном случае – значение 0.

Заметки

Загруженное растровое изображение присоединяется к объекту CBitmap.

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

Можно использовать функцию CGdiObject::DeleteObject для удаления растровое изображение, загруженное функцией LoadBitmap или деструктор CBitmap удаляет объект.

Предупреждающее замечаниеВнимание

Прежде чем удалить объект, убедитесь в том, что он не выделен в контекст устройства.

Следующие растровые изображения были добавлены к версиям Windows 3,1 и более поздних версий:

OBM_UPARRROWIOBM_DNARROWIOBM_RGARROWIOBM_LFARROWI

Эти растровые изображения не найдены в драйверах устройств на Windows версии 3.0 и более ранних версий.Полный список растровых изображений и отображением их вид см. в разделе Windows SDK.

Требования

Header: afxwin.h

См. также

Ссылки

Класс CBitmap

Диаграмма иерархии

CBitmap::LoadOEMBitmap

LoadBitmap

CGdiObject::DeleteObject