На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

LoadBitmap



The LoadBitmap function loads the specified bitmap resource from a module's executable file.

HBITMAP LoadBitmap(

HINSTANCE hInstance, // handle of application instance
LPCTSTR lpBitmapName // address of bitmap resource name
);


Parameters

hInstance

Identifies the instance of the module whose executable file contains the bitmap to be loaded.

lpBitmapName

Points to a null-terminated string that contains the name of the bitmap resource to be loaded. Alternatively, this parameter can consist of the resource identifier in the low-order word and zero in the high-order word. The MAKEINTRESOURCE macro can be used to create this value.



Return Values

If the function succeeds, the return value is the handle of the specified bitmap.
If the function fails, the return value is NULL.

Remarks

If the bitmap pointed to by the lpBitmapName parameter does not exist or there is insufficient memory to load the bitmap, the function fails.
An application can use the LoadBitmap function to access the predefined bitmaps used by the Win32 API. To do so, the application must set the hInstance parameter to NULL and the lpBitmapName parameter to one of the following values:

OBM_BTNCORNERS OBM_OLD_RESTORE
OBM_BTSIZE OBM_OLD_RGARROW
OBM_CHECK OBM_OLD_UPARROW
OBM_CHECKBOXES OBM_OLD_ZOOM
OBM_CLOSE OBM_REDUCE
OBM_COMBO OBM_REDUCED
OBM_DNARROW OBM_RESTORE
OBM_DNARROWD OBM_RESTORED
OBM_DNARROWI OBM_RGARROW
OBM_LFARROW OBM_RGARROWD
OBM_LFARROWD OBM_RGARROWI
OBM_LFARROWI OBM_SIZE
OBM_MNARROW OBM_UPARROW
OBM_OLD_CLOSE OBM_UPARROWD
OBM_OLD_DNARROW OBM_UPARROWI
OBM_OLD_LFARROW OBM_ZOOM
OBM_OLD_REDUCE OBM_ZOOMD


Bitmap names that begin with OBM_OLD represent bitmaps used by Windows versions earlier than 3.0.
For an application to use any of the OBM_ constants, the constant OEMRESOURCE must be defined before the WINDOWS.H header file is included.
The application must call the DeleteObject function to delete each bitmap handle returned by the LoadBitmap function.

See Also

CreateBitmap, DeleteObject, LoadCursor, LoadIcon, MAKEINTRESOURCE


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

LoadBitmap



Функция LoadBitmap загружает определенный ресурс побитового отображения из модульного выполняемого файла.

HBITMAP LoadBitmap(

hInstance HINSTANCE, // РУЧКА прикладного адреса примера LPCTSTR lpBitmapName // имени ресурса побитового отображения
);


Параметры

hInstance

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

lpBitmapName

Точки на недействительный расторгнутую строку, которые содержат имя ресурса побитового отображения, которое нужно загружаться. Кроме того, этот параметр может состоять из идентификатора ресурса в младшем слове и нуле в старшем слове. Макро MAKEINTRESOURCE может быть использовано, чтобы создавать эту величину.



Обратные Величины

Если функция добивается успеха, обратная величина является ручкой определенного побитового отображения.
Если функция терпит неудачу, обратная величина НЕДЕЙСТВИТЕЛЬНА.

Замечания

Если побитовое отображение указывалось бы, чтобы параметром lpBitmapName не существует или есть недостаточная память, чтобы загружать побитовое отображение, функция терпит неудачу.
Приложение может использовать функцию LoadBitmap, чтобы иметь доступ ко встроенным побитовым отображениям использованным Win32 API. Чтобы делать так, приложение должно установить параметр hInstance в НЕДЕЙСТВИТЕЛЬНЫЙ и параметр lpBitmapName в одно из следующего величин:

OBM_BTNCORNERS OBM_OLD_RESTORE OBM_BTSIZE OBM_OLD_RGARROW OBM_CHECK OBM_OLD_UPARROW OBM_CHECKBOXES OBM_OLD_ZOOM OBM_CLOSE OBM_REDUCE OBM_COMBO OBM_REDUCED OBM_DNARROW OBM_RESTORE OBM_DNARROWD OBM_RESTORED OBM_DNARROWI OBM_RGARROW OBM_LFARROW OBM_RGARROWD OBM_LFARROWD OBM_RGARROWI OBM_LFARROWI OBM_SIZE OBM_MNARROW OBM_UPARROW OBM_OLD_CLOSE OBM_UPARROWD OBM_OLD_DNARROW OBM_UPARROWI OBM_OLD_LFARROW OBM_ZOOM OBM_OLD_REDUCE OBM_ZOOMD


Побитовое отображение называет, что начинает с OBM_OLD представлять побитовые отображения использованные версиями Окна раньше чем 3.0.
Для приложения, чтобы использовать любую из констант OBM_, константа OEMRESOURCE должна быть определена прежде, чем файл заголовка WINDOWS.H будет включен.
Приложение должно назвать функцию DeleteObject, чтобы удалять каждую ручку побитового отображения возвращанную функцией LoadBitmap.

Смотри Также

CreateBitmap, DeleteObject, LoadCursor, LoadIcon, MAKEINTRESOURCE


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz