Compartir a través de

Función LoadIconWithScaleDown (commctrl.h)

  • Artículo

Carga un icono. Si el icono no es un tamaño estándar, esta función reduce verticalmente una imagen más grande en lugar de escalar verticalmente una imagen más pequeña.

Sintaxis

HRESULT LoadIconWithScaleDown(
  [in]  HINSTANCE hinst,
  [in]  PCWSTR    pszName,
  [in]  int       cx,
  [in]  int       cy,
  [out] HICON     *phico
);

Parámetros

[in] hinst

Tipo: HINSTANCE

Identificador del módulo de un archivo DLL o ejecutable (.exe) que contiene el icono que se va a cargar. Para obtener más información, vea GetModuleHandle.

Para cargar un icono de sistema predefinido o un archivo de icono independiente, establezca este parámetro en NULL.

[in] pszName

Tipo: PCWSTR

Puntero a un búfer Unicode terminado en null que contiene información de ubicación sobre el icono que se va a cargar.

Si hinst no es NULL, pszName especifica el recurso de icono por nombre o ordinal. Este ordinal debe empaquetarse mediante la macro MAKEINTRESOURCE .

Si hinst es NULL, pszName especifica el identificador (empezando por el prefijo IDI_) de un icono de sistema predefinido que se va a cargar.

[in] cx

Tipo: int

Ancho deseado, en píxeles, del icono.

[in] cy

Tipo: int

Alto deseado, en píxeles, del icono.

[out] phico

Tipo: HICON*

Cuando esta función vuelve, contiene un puntero al identificador del icono cargado.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o un valor de error de lo contrario, incluido lo siguiente:

Código devuelto Descripción
E_INVALIDARG
 El contenido del búfer al que apunta pszName no se ajusta a ninguna de las interpretaciones esperadas.

Comentarios

Esta función buscará primero en el archivo de icono un icono que tenga exactamente el mismo tamaño. Si no se encuentra una coincidencia, a menos que cx y cy coincidan con uno de los tamaños de icono estándar (16, 32, 48 o 256 píxeles), se selecciona el siguiente icono más grande y, a continuación, se reduce verticalmente al tamaño deseado. Por ejemplo, si la aplicación solicita un icono con una dimensión x de 40 píxeles, se usa el icono de 48 píxeles y se reduce verticalmente a 40 píxeles. En cambio, la función LoadImage selecciona el icono de 32 píxeles y lo escala hasta 40 píxeles.

Si la función no puede encontrar un icono más grande, el valor predeterminado es el comportamiento estándar de buscar el siguiente icono más pequeño y escalarlo verticalmente hasta el tamaño deseado.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado commctrl.h
Library Comctl32.lib
Archivo DLL Comctl32.dll