LookupIconIdFromDirectory-Funktion (winuser.h)
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 |
Siehe auch
Konzept
Referenz