|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| user32.lib
| Header File
| winuser.h
| Unicode
| No
| Platform Notes
| None
|
|
|
LoadImage
[Now Supported on Windows NT]
The LoadImage function loads an icon, cursor, or bitmap.
HANDLE LoadImage(
HINSTANCE hinst,
| // handle of the instance that contains the image
| LPCTSTR lpszName,
| // name or identifier of image
| UINT uType,
| // type of image
| int cxDesired,
| // desired width
| int cyDesired,
| // desired height
| UINT fuLoad
| // load flags
| );
|
|
Parameters
hinst
Identifies an instance of the module that contains the image to be loaded. To
load an OEM image, set this parameter to zero.
lpszName
Identifies the image to load.
If the hinst parameter is non-NULL and the fuLoad parameter does not include LR_LOADFROMFILE, lpszName is a pointer to a null-terminated string that contains the name of the image
resource in the hinst module.
If hinst is NULL and LR_LOADFROMFILE is not specified, the low-order word of this
parameter must be the identifier of the OEM image to load. The OEM image
identifiers are defined in WINUSER.H and have the following prefixes:
Prefix
| Meaning
| OBM_
| OEM bitmaps
| OIC_
| OEM icons
| OCR_
| OEM cursors
|
Windows 95: If the fuLoad parameter includes the LR_LOADFROMFILE value, lpszName is the name of the file that contains the image.
Windows NT: LR_LOADFROMFILE is not supported.
uType
Specifies the type of image to be loaded. This parameter can be one of the
following values:
Value
| Meaning
| IMAGE_BITMAP
| Loads a bitmap.
| IMAGE_CURSOR
| Loads a cursor.
| IMAGE_ICON
| Loads an icon.
|
cxDesired
Specifies the width, in pixels, of the icon or cursor. If this parameter is
zero and the fuLoad parameter is LR_DEFAULTSIZE, the function uses the SM_CXICON or SM_CXCURSOR
system metric value to set the width. If this parameter is zero and
LR_DEFAULTSIZE is not used, the function uses the actual resource width.
cyDesired
Specifies the height, in pixels, of the icon or cursor. If this parameter is
zero and the fuLoad parameter is LR_DEFAULTSIZE, the function uses the SM_CYICON or SM_CYCURSOR
system metric value to set the height. If this parameter is zero and
LR_DEFAULTSIZE is not used, the function uses the actual resource height.
fuLoad
Specifies a combination of the following values:
Value
| Meaning
| LR_DEFAULTCOLOR
| The default flag; it does nothing. All it means is "not LR_MONOCHROME".
| LR_CREATEDIBSECTION
| When the uType parameter specifies IMAGE_BITMAP, causes the function to return a DIB section
bitmap rather than a compatible bitmap. This flag is useful for loading a
bitmap without mapping it to the colors of the display device.
| LR_DEFAULTSIZE
| Uses the width or height specified by the system metric values for cursors or
icons, if the cxDesired or cyDesired values are set to zero. If this flag is not specified and cxDesired and cyDesired are set to zero, the function uses the actual resource size. If the resource
contains multiple images, the function uses the size of the first image.
| LR_LOADFROMFILE
| Loads the image from the file specified by the lpszName parameter. If this flag is not specified, lpszName is the name of the resource.
| LR_LOADMAP3DCOLORS
| Searches the color table for the image and replaces the following shades of
gray with the corresponding 3D color:
|
Color
| Replaced with
| Dk Gray, RGB(128,128,128)
| COLOR_3DSHADOW
| Gray, RGB(192,192,192)
| COLOR_3DFACE
| Lt Gray, RGB(223,223,223)
| COLOR_3DLIGHT
|
LR_LOADTRANSPARENT
| Retrieves the color value of the first pixel in the image and replaces the
corresponding entry in the color table with the default window color
(COLOR_WINDOW). All pixels in the image that use that entry become the default window color.
This value applies only to images that have corresponding color tables.
If fuLoad includes both the LR_LOADTRANSPARENT and LR_LOADMAP3DCOLORS values,
LRLOADTRANSPARENT takes precedence. However, the color table entry is replaced with
COLOR_3DFACE rather than COLOR_WINDOW.
| LR_MONOCHROME
| Loads the image in black and white.
| LR_SHARED
| Shares the image handle if the image is loaded multiple times. If LR_SHARED is
not set, a second call to LoadImage for the same resource will load the image again and return a different handle.
Do not use LR_SHARED for images that have non-standard sizes, that may change
after loading, or that are loaded from a file.
|
Return Values
If the function succeeds, the return value is the handle of the newly loaded
image.
If the function fails, the return value is NULL.
See Also
CopyImage, GetSystemMetrics, LoadBitmap, LoadCursor, LoadIcon
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
