LookupIconIdFromDirectory-Funktion (winuser.h)

Artikel
03/04/2024

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

Um eine gewünschte Höhe oder Breite anzugeben, verwenden Sie die LookupIconIdFromDirectoryEx-Funktion . Diese Funktion ruft sie auf, indem sie null in den cxDesired/cyDesired-Parametern übergibt.

Syntax

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

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.

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.

Hinweise

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. LookupIconIdFromDirectory 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 dem Ressourcentyp RT_GROUP_ICON (oder RT_GROUP_CURSOR für Cursor) und einem ganzzahligen Ressourcennamen für das zu ladende Symbol geladen. LookupIconIdFromDirectory gibt einen ganzzahligen Bezeichner zurück, der der Ressourcenname des Symbols ist, das am besten zum aktuellen Anzeigegerät passt.

Die Funktionen LoadIcon, LoadCursor und LoadImage verwenden diese Funktion, um die angegebenen Ressourcendaten nach dem Symbol oder Cursor zu durchsuchen, das am besten zum aktuellen Anzeigegerät passt.

Anforderungen

Anforderung	Wert
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