|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| user32.lib
| Header File
| winuser.h
| Unicode
| No
| Platform Notes
| None
|
|
|
CopyImage
The CopyImage function creates a new image (icon, cursor, or bitmap) and copies the
attributes of the specified image to the new one. If necessary, the function stretches
the bits to fit the desired size of the new image.
HANDLE CopyImage(
HANDLE hImage,
| // handle to the image to copy
| UINT uType,
| // type of image to copy
| int cxDesired,
| // desired width of new image
| int cyDesired,
| // desired height of new image
| UINT fuFlags
| // copy flags
| );
|
|
Parameters
hinst
Identifies an instance of the module that contains the image to be copied.
uType
Specifies the type of image to be copied. This parameter can be one of the
following values:
Value
| Meaning
| IMAGE_BITMAP
| Copies a bitmap.
| IMAGE_CURSOR
| Copies a cursor.
| IMAGE_ICON
| Copies an icon.
|
cxDesired
Specifies the desired width, in pixels, of the image.
cyDesired
Specifies the desired height, in pixels, of the image.
fuFlags
Specifies a combination of the following values:
Value
| Meaning
| LR_COPYDELETEORG
| Deletes the original image after creating the copy.
| LR_COPYRETURNORG
| Creates an exact copy of the image, ignoring the cxDesired and cyDesired parameters.
| LR_MONOCHROME
| Creates a new monochrome image.
| LR_COPYFROMRESOURCE
| Tries to reload an icon or cursor resource from the original resource file
rather than simply copying the current image. This is useful for creating a
different-sized copy when the resource file contains multiple sizes of the resource.
Without this flag, CopyImage stretches the original image to the new size. If this flag is set, CopyImage uses the size in the resource file closest to the desired size.
This will succeed only if hImage was loaded by LoadIcon or LoadCursor, or by LoadImage with the LR_SHARED flag.
|
Return Values
If the function succeeds, the return value is the handle to the newly created
image.
If the function fails, the return value is NULL. To get extended error
information, call GetLastError.
See Also
LoadImage
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
More Online Helps
Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
