EnumObjects-Funktion (wingdi.h)
Die EnumObjects-Funktion listet die Stifte oder Pinsel auf, die für den angegebenen Gerätekontext (Device Context, DC) verfügbar sind. Diese Funktion ruft die anwendungsdefinierte Rückruffunktion einmal für jedes verfügbare Objekt auf und liefert Daten, die dieses Objekt beschreiben. EnumObjects setzt den Aufruf der Rückruffunktion fort, bis die Rückruffunktion null zurückgibt oder bis alle Objekte aufgelistet wurden.
Syntax
int EnumObjects(
[in] HDC hdc,
[in] int nType,
[in] GOBJENUMPROC lpFunc,
[in] LPARAM lParam
);
Parameter
[in] hdc
Ein Handle für den DC.
[in] nType
Der Objekttyp. Dieser Parameter kann OBJ_BRUSH oder OBJ_PEN sein.
[in] lpFunc
Ein Zeiger auf die anwendungsdefinierte Rückruffunktion. Weitere Informationen zur Rückruffunktion finden Sie in der Funktion EnumObjectsProc .
[in] lParam
Ein Zeiger auf die anwendungsdefinierte Daten. Die Daten werden zusammen mit den Objektinformationen an die Rückruffunktion übergeben.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert der letzte Wert, der von der Rückruffunktion zurückgegeben wird. Seine Bedeutung ist benutzerdefinierte.
Wenn die Objekte nicht aufgelistet werden können (z. B. gibt es zu viele Objekte), gibt die Funktion null zurück, ohne die Rückruffunktion aufzurufen.
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 | wingdi.h (einschließlich Windows.h) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |