GetCurrentObject-Funktion (wingdi.h)

Artikel
03/06/2024

Die GetCurrentObject-Funktion ruft ein Handle für ein Objekt des angegebenen Typs ab, das im angegebenen Gerätekontext (Device Context, DC) ausgewählt wurde.

Syntax

HGDIOBJ GetCurrentObject(
  [in] HDC  hdc,
  [in] UINT type
);

Parameter

[in] hdc

Ein Handle für den DC.

[in] type

Der objekttyp, der abgefragt werden soll. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
OBJ_BITMAP	Gibt die aktuell ausgewählte Bitmap zurück.
OBJ_BRUSH	Gibt den aktuell ausgewählten Pinsel zurück.
OBJ_COLORSPACE	Gibt den aktuellen Farbraum zurück.
OBJ_FONT	Gibt die aktuell ausgewählte Schriftart zurück.
OBJ_PAL	Gibt die aktuell ausgewählte Palette zurück.
OBJ_PEN	Gibt den aktuell ausgewählten Stift zurück.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das angegebene Objekt.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL.

Hinweise

Eine Anwendung kann die Funktionen GetCurrentObject und GetObject verwenden, um Beschreibungen der grafikspezifischen Objekte abzurufen, die derzeit im angegebenen DC ausgewählt sind.

Beispiele

Ein Beispiel finden Sie unter Abrufen Graphic-Object Attribute und Auswählen neuer Grafikobjekte.

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