LookupIconIdFromDirectoryEx-Funktion (winuser.h)

Artikel
05/25/2023

Durchsucht Symbol- (RT_GROUP_ICON) oder Cursorressourcendaten (RT_GROUP_CURSOR) nach dem Symbol oder Cursor, das am besten zum aktuellen Anzeigegerät passt.

Wenn mehr als ein Image in der Ressourcengruppe vorhanden ist, verwendet diese Methode die folgenden Kriterien, um ein Bild auszuwählen:

Das Bild, das am nächsten liegt, aber die angeforderte Größe nicht überschreitet, wird ausgewählt.
Wenn mindestens zwei Bilder dieser Größe vorhanden sind, wird das Bild ausgewählt, das der Farbtiefe der Anzeige entspricht.
Wenn keine Bilder genau mit der Farbtiefe des Displays übereinstimmen, wird das Bild mit der größten Farbtiefe ausgewählt, die die Farbtiefe der Anzeige nicht überschreitet. Wenn alle die Farbtiefe überschreiten, wird die Farbtiefe mit der niedrigsten Farbtiefe ausgewählt.

Syntax

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

Parameter

[in] presbits

Typ: PBYTE

Die Symbol- oder Cursorverzeichnisdaten. Da diese Funktion die Ressourcendaten nicht überprüft, verursacht sie einen Gp-Fehler (General Protection) oder gibt einen undefinierten Wert zurück, wenn Presbits nicht auf gültige Ressourcendaten verweist.

[in] fIcon

Typ: BOOL

Gibt an, ob ein Symbol oder ein Cursor gesucht wird. Wenn dieser Parameter TRUE ist, sucht die Funktion nach einem Symbol. wenn der Parameter FALSE ist, sucht die Funktion nach einem Cursor.

[in] cxDesired

Typ: int

Die gewünschte Breite des Symbols in Pixel. Wenn dieser Parameter 0 ist, verwendet die Funktion den SM_CXICON - oder SM_CXCURSOR Systemmetrikwert.

[in] cyDesired

Typ: int

Die gewünschte Höhe des Symbols in Pixel. Wenn dieser Parameter 0 ist, verwendet die Funktion den SM_CYICON oder SM_CYCURSOR Systemmetrikwert.

[in] Flags

Typ: UINT

Eine Kombination der folgenden Werte.

Wert	Bedeutung
LR_DEFAULTCOLOR 0x00000000	Verwendet das Standardfarbformat.
LR_MONOCHROME 0x00000001	Erstellt ein monochromes Symbol oder einen Cursor.

Rückgabewert

Typ: int

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein ganzzahliger Ressourcenbezeichner für das Symbol (RT_ICON) oder den Cursor (RT_CURSOR), der am besten zum aktuellen Anzeigegerät passt.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Bemerkungen

Eine Ressourcendatei vom Typ RT_GROUP_ICON (RT_GROUP_CURSOR cursors) enthält Symboldaten (oder Cursordaten) in mehreren geräteabhängigen und geräteunabhängigen Formaten. LookupIconIdFromDirectoryEx durchsucht die Ressourcendatei nach dem Symbol (oder Cursor), das dem aktuellen Anzeigegerät am besten entspricht, und gibt den ganzzahligen Bezeichner zurück. Die Funktionen FindResource und FindResourceEx verwenden das MAKEINTRESOURCE-Makro mit diesem Bezeichner, um die Ressource im Modul zu suchen.

Das Symbolverzeichnis wird aus einer Ressourcendatei mit ressourcentyp RT_GROUP_ICON (oder RT_GROUP_CURSOR für Cursor) und einem ganzzahligen Ressourcennamen für das zu ladende Symbol (RT_ICON) oder Cursor (RT_CURSOR) geladen. LoadResource - und CreateIconFromResourceEx-Funktionen können verwendet werden, um ein entsprechendes Symbol oder einen entsprechenden Cursor zu erstellen.

Die Funktionen LoadIcon, LoadImage und LoadCursor verwenden diese Funktion, um die angegebenen Ressourcendaten nach dem Symbol oder Cursor zu durchsuchen, das am besten zum aktuellen Anzeigegerät passt. LoadIconWithScaleDown verwendet alternative Suchkriterien, um eine optimale Anpassung zu erzielen.

Beispiele

Ein Beispiel finden Sie unter Freigeben von Symbolressourcen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll