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

Weitere Informationen

Gerätekontextfunktionen

Übersicht über Gerätekontexte

EnumObjectsProc

GetObject