Función DrawIcon (winuser.h)

Artículo
27/01/2024

Dibuja un icono o cursor en el contexto de dispositivo especificado.

Para especificar opciones de dibujo adicionales, use la función DrawIconEx .

Sintaxis

C++

BOOL DrawIcon(
  [in] HDC   hDC,
  [in] int   X,
  [in] int   Y,
  [in] HICON hIcon
);

Parámetros

[in] hDC

Tipo: HDC

Identificador del contexto del dispositivo en el que se dibujará el icono o el cursor.

[in] X

Tipo: int

Coordenada x lógica de la esquina superior izquierda del icono.

[in] Y

Tipo: int

Coordenada y lógica de la esquina superior izquierda del icono.

[in] hIcon

Tipo: HICON

Identificador del icono que se va a dibujar.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

DrawIcon coloca la esquina superior izquierda del icono en la ubicación especificada por los parámetros X e Y . La ubicación está sujeta al modo de asignación actual del contexto de dispositivo.

DrawIcon dibuja el icono o cursor utilizando el ancho y alto especificados por los valores de métrica del sistema para los iconos; para obtener más información, vea GetSystemMetrics.

La función DrawIcon llama a DrawIconEx pasando DI_NORMAL|DI_DEFAULTSIZE como marcas.

Ejemplos

Para obtener un ejemplo, vea Mostrar un icono.

Requisitos


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-1 (introducido en Windows 10, versión 10.0.14393)