winuser.h


LookupIconIdFromDirectory

La función LookupIconIdFromDirectory busca a través de los datos de iconos o cursores uno que se ajuste lo mejor posible al dispositivo de visualización.

Sintaxis

int LookupIconIdFromDirectory(
    PBYTE presbits,  // dirección de datos de recurso
    BOOL fIcon       // buscar un icono o cursor
   );

Parámetros

presbits: puntero a un directorio de datos de iconos o cursores. Ya que esta función no valida los datos de recurso, provocará un fallo de protección general (GP) o devolverá un valor indefinido si presbits no apunta a unos datos de recurso válidos.

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

Valor de retorno

Si la función tiene éxito, el valor de retorno es un identificador entero de recurso del icono o cursor que mejor se ajuste al dispositivo de visualización actual.

Observaciones

Un fichero de recursos del tipo RT_GROUP_ICON (RT_GROUP_CURSOR indica cursores) contiene datos de iconos (o cursores) en varios formatos dependeintes e independientes del dispositivo. LookupIconIdFromDirectory busca en el fichero de recursos el icono (o cursor) que mejor se ajuste al dispositivo actual y devuelve su identificador entero. Las funciones FindResource y FindResourceEx usan la macro MAKEINTRESOURCE con este identificador para localizar el recurso dentro del módulo.

El directorio de iconos se carga desde el fichero de recursos con el tipo de recurso RT_GROUP_ICON (o RT_GROUP_CURSOR para cursores), y un nombre de recurso entero especificado para el icono a cargar. LookupIconIdFromDirectory devuelve un identificador entero que es el nombre del recurso del icono que mejor se ajusta el dispositivo de visualización actual.

Las funciones LoadIcon, LoadCursor y LoadImage (en Windows 95) usan esta función para buscar en los datos de recurso especificados un icono o cursor que se ajuste lo mejor posible al dispositivo de visualización actual.