Función LookupIconIdFromDirectory (winuser.h)

Artículo
03/04/2024

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 visualización actual.

Para especificar un alto o ancho deseado, use la función LookupIconIdFromDirectoryEx . Esta función la llama pasando cero en los parámetroscxDesired cyDesired/.

Sintaxis

int LookupIconIdFromDirectory(
  [in] PBYTE presbits,
  [in] BOOL  fIcon
);

Parámetros

[in] presbits

Tipo: PBYTE

Los datos de directorio de cursor o icono. Dado que esta función no valida los datos de recursos, provoca un error de protección general (GP) o devuelve un valor indefinido si presbits no apunta 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.

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 ajusta al dispositivo de visualización 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. LookupIconIdFromDirectory busca en el archivo de recursos el icono (o cursor) que mejor se ajusta al dispositivo de pantalla actual y devuelve 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 que se va a cargar. LookupIconIdFromDirectory devuelve un identificador entero que es el nombre del recurso del icono que mejor se ajusta al dispositivo de visualización actual.

Las funciones LoadIcon, LoadCursor y LoadImage 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.

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 (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll