Función CopyImage (winuser.h)
Crea una nueva imagen (icono, cursor o mapa de bits) y copia los atributos de la imagen especificada en la nueva. Si es necesario, la función amplía los bits para ajustarse al tamaño deseado de la nueva imagen.
Sintaxis
HANDLE CopyImage(
[in] HANDLE h,
[in] UINT type,
[in] int cx,
[in] int cy,
[in] UINT flags
);
Parámetros
[in] h
Tipo: HANDLE
Identificador de la imagen que se va a copiar.
[in] type
Tipo: UINT
Tipo de imagen que se va a copiar. Este parámetro puede ser uno de los valores siguientes.
| Valor | Significado |
|---|---|
|
Copia un mapa de bits. |
|
Copia un cursor. |
|
Copia un icono. |
[in] cx
Tipo: int
Ancho deseado, en píxeles, de la imagen. Si es cero, la imagen devuelta tendrá el mismo ancho que el hImage original.
[in] cy
Tipo: int
Alto deseado, en píxeles, de la imagen. Si es cero, la imagen devuelta tendrá el mismo alto que el hImage original.
[in] flags
Tipo: UINT
Este parámetro puede ser uno o más de los siguientes valores.
| Valor | Significado |
|---|---|
|
Elimina la imagen original después de crear la copia. |
|
Intenta volver a cargar un icono o un recurso de cursor desde el archivo de recursos original en lugar de simplemente copiar la imagen actual. Esto resulta útil para crear una copia de tamaño diferente cuando el archivo de recursos contiene varios tamaños del recurso. Sin esta marca, CopyImage amplía la imagen original al nuevo tamaño. Si se establece esta marca, CopyImage usa el tamaño del archivo de recursos más cercano al tamaño deseado. Esto solo se realizará correctamente si LoadIcon o LoadCursor cargó hImage o LoadImage con la marca LR_SHARED. |
|
Devuelve el hImage original si cumple los criterios de la copia (es decir, dimensiones correctas y profundidad de color), en cuyo caso se omite la marca LR_COPYDELETEORG . Si no se especifica esta marca, siempre se crea un nuevo objeto. |
|
Si se establece y se crea un nuevo mapa de bits, el mapa de bits se crea como una sección DIB. De lo contrario, la imagen de mapa de bits se crea como un mapa de bits dependiente del dispositivo. Esta marca solo es válida si uType es IMAGE_BITMAP. |
|
Usa el formato de color predeterminado. |
|
Usa el ancho o alto especificado por los valores de métrica del sistema para cursores o iconos, si los valores cxDesired o cyDesired se establecen en cero. Si no se especifica esta marca y cxDesired y cyDesired se establecen en cero, la función usa el tamaño real del recurso. Si el recurso contiene varias imágenes, la función usa el tamaño de la primera imagen. |
|
Crea una nueva imagen monocromática. |
Valor devuelto
Tipo: HANDLE
Si la función se realiza correctamente, el valor devuelto es el identificador de la imagen recién creada.
Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Cuando haya terminado de usar el recurso, puede liberar su memoria asociada llamando a una de las funciones de la tabla siguiente.
| Recurso | Función Release |
|---|---|
| Bitmap | DeleteObject |
| Cursor | DestroyCursor |
| Icono | Destroyicon |
El sistema elimina automáticamente el recurso cuando finaliza su proceso, pero al llamar a la función adecuada se ahorra memoria y se reduce el tamaño del espacio de trabajo del proceso.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winuser.h (incluir Windows.h) |
| Library | User32.lib |
| Archivo DLL | User32.dll |
| Conjunto de API | ext-ms-win-ntuser-gui-l1-3-0 (introducido en Windows 10, versión 10.0.10240) |
Consulte también
Conceptual
Referencia