Función LookupIconIdFromDirectoryEx (winuser.h)

Artículo
05/25/2023

Busca datos de recursos de icono (RT_GROUP_ICON) o cursor (RT_GROUP_CURSOR) para el icono o cursor que mejor se adapte al dispositivo de pantalla actual.

Si hay más de una imagen en el grupo de recursos, este método usa los criterios siguientes para elegir una imagen:

La imagen más cercana, pero no supera el tamaño solicitado, está seleccionada.
Si hay dos o más imágenes de ese tamaño, se elige la que coincide con la profundidad de color de la pantalla.
Si ninguna imagen coincide exactamente con la profundidad de color de la pantalla, se elige la imagen con la mayor profundidad de color que no supera la profundidad de color de la pantalla. Si todas superan la profundidad de color, se elige la que tiene la profundidad de color más baja.

Sintaxis

int LookupIconIdFromDirectoryEx(
  [in] PBYTE presbits,
  [in] BOOL  fIcon,
  [in] int   cxDesired,
  [in] int   cyDesired,
  [in] UINT  Flags
);

Parámetros

[in] presbits

Tipo: PBYTE

El icono o los datos del directorio del cursor. Dado que esta función no valida los datos de recursos, produce un error de protección general (GP) o devuelve un valor no definido si los presbits no apuntan a datos de recursos válidos.

[in] fIcon

Tipo: BOOL

Indica si se busca un icono o un cursor. Si este parámetro es TRUE, la función busca un icono; si el parámetro es FALSE, la función busca un cursor.

[in] cxDesired

Tipo: int

Ancho deseado, en píxeles, del icono. Si este parámetro es cero, la función usa el SM_CXICON o SM_CXCURSOR valor de métrica del sistema.

[in] cyDesired

Tipo: int

Alto deseado, en píxeles, del icono. Si este parámetro es cero, la función usa el SM_CYICON o SM_CYCURSOR valor de métrica del sistema.

[in] Flags

Tipo: UINT

Combinación de los valores siguientes.

Valor	Significado
LR_DEFAULTCOLOR 0x00000000	Usa el formato de color predeterminado.
LR_MONOCHROME 0x00000001	Crea un icono o cursor monocromáticos.

Valor devuelto

Tipo: int

Si la función se ejecuta correctamente, el valor devuelto es un identificador de recurso entero para el icono (RT_ICON) o cursor (RT_CURSOR) que mejor se adapte al dispositivo de pantalla actual.

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

Comentarios

Un archivo de recursos de tipo RT_GROUP_ICON (RT_GROUP_CURSOR indica cursores) contiene datos de icono (o cursor) en varios formatos dependientes del dispositivo y independientes del dispositivo. LookupIconIdFromDirectoryEx busca en el archivo de recursos el icono (o cursor) que mejor se adapte al dispositivo de pantalla actual y devuelva su identificador entero. Las funciones FindResource y FindResourceEx usan la macro MAKEINTRESOURCE con este identificador para buscar el recurso en el módulo.

El directorio de iconos se carga desde un archivo de recursos con el tipo de recurso RT_GROUP_ICON (o RT_GROUP_CURSOR para cursores) y un nombre de recurso entero para el icono específico (RT_ICON) o cursor (RT_CURSOR) que se va a cargar. Las funciones LoadResource y CreateIconFromResourceEx se pueden usar para crear un icono o cursor correspondientes.

Las funciones LoadIcon, LoadImage y LoadCursor usan esta función para buscar los datos de recursos especificados para el icono o cursor que mejor se adapte al dispositivo de visualización actual. LoadIconWithScaleDown usa criterios de búsqueda alternativos para una mejor opción.

Ejemplos

Para obtener un ejemplo, vea Compartir recursos de 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