This function creates an ImageMan image from a Windows device independent bitmap (DIB) and returns an ImageMan handle to the caller.
|
Parameter |
Type |
Description |
|
hDIB |
HANDLE |
A handle to a DIB in packed DIB format. ImageMan takes responsibility for the DIB when the function is completed. |
Return Value
The return value is a valid ImageMan image handle on success, NULL on failure.
Comments
Once the call has completed, the application can treat this image as it would any other ImageMan image, with the caveat that the image cannot be unloaded via ImgUnload. Also, a call to ImgGetInfo will return the IMG_MEM_BASED flag in the lFlags parameter to indicate that this image has no external file to recreate itself from.
Your application should not free the DIB it has passed in since ImageMan will do that when ImgClose is called on the returned ImageMan handle.
© 1995-2004 Data Techniques, Inc. All rights reserved.