winuser.h


DrawIconEx

La función DrawIconEx muestra un icono o cursor en el área de cliente de la ventana del contexto de dispositivo especificado, realizando las operaciones de rastreo especificadas, y estirando o comprimiendo el icono o cursor como se especifique.

Sintaxis

BOOL DrawIconEx(
    HDC hdc,                    // manipulador de contexto de dispositivo
    int xLeft,                  // coordenada x de la esquina superior izquierda
    int yTop,                   // coordenada y de la esquina superior izquierda
    HICON hIcon,                // manipulador del icono a trazar
    int cxWidth,                // anchura del icono
    int cyWidth,                // altura del icono
    UINT istepIfAniCur,         // índice del fotograma en un cursor animado
    HBRUSH hbrFlickerFreeDraw,  // manipulador del pincel de fondo
    UINT diFlags                // banderas de trazado de icono
   );

Parámetros

hdc: identifica el contexto de dispositivo de la ventana.

xLeft: especifica la coordenada x lógica de la esquina superior izquierda del icono o cursor.

yTop: especifica la coordenada y lógica de la esquina superior izquierda del icono o cursor.

hIcon: identifica el icono o cursor a mostrar. Este parámetros puede referirse a un cursor animado. El recurso de icono o cursor debe haber sido cargado previamente mediante la función LoadImage.

cxWidth: especifica la anchura lógica del icono o cursor. Si este parámetro es cero y el parámetro diFlags es DI_DEFAULTSIZE, la función usa el valor de métrica del sistema SM_CXICON o SM_CXCURSOR como ancho. Si este parámetro es cero y no se usa DI_DEFAULTSIZE, la función usa la anchura actual del recurso.

cyWidth: especifica la altura lógica del icono o cursor. Si este parámetro es cero y el parámetro diFlags es DI_DEFAULTSIZE, la función usa el valor de métrica del sistema SM_CYICON o SM_CYCURSOR como altura. Si este parámetro es cero y no se usa DI_DEFAULTSIZE, la función usa la altura actual del recurso.

istepIfAniCur: especifica el índice del fotograma a mostrar, si hIcon identifica un cursor animado. Este parámetro es ignorado si hIcon no identifica a un cursor animado.

hbrFlickerFreeDraw: identifica un pincel que el sistema usa para un trazado sin parpadeo. Si hbrBkgnd es un manipulador de pincel válido, el sistema crea un mapa de bits fuera de pantalla usando el pincel especificado para el color de fondo, dibuja el icono o cursor en el mapa de bits y después copia el mapa de bits resultante en el contexto de dispositivo identificado por hdc. Si hbrBkgnd es NULL, el sistema dibuja el icono o cursor directamente en en contexto de dispositivo.

diFlags: especifica las banderas de trazado. Este parámetro puede ser uno de los siguientes valores:

Valor Significado
DI_COMPAT Dibuja el icono o cursor usando la imagen de sistema por defecto en lugar de la especificada por el usuario.
DI_DEFAULTSIZE Dibuja el icono o cursor usando la anchura y altura especificadas por los valores de métrica del sistema para cursores e iconos, si los parámetros cxWidth y cyWidth se ponen a cero. Si este banderín no se especifica y cxWidth y cyWidth no son cero, la función usa el tamaño actual del recurso.
DI_IMAGE Realiza la operación de rastreo especificada por ropImage.
DI_MASK Realiza la operación de rastreo especificada por ropMask.
DI_NORMAL Combinación de DI_IMAGE y DI_MASK.

Valor de retorno

Si la función tiene éxito, el valor de retorno será distinto de cero.

Si la función falla, el valor de retorno es cero. Para obtener información adicional sobre el error, llamar a GetLastError.

Observaciones

DrawIconEx sitúa la esquina superior izquierda del icono en la posición especificada por los parámetros X y Y. Esta situación está sujeta al modo de proyección actual del contexto de dispositivo.