SelectObject-Funktion (wingdi.h)

Artikel
03/04/2024

Die SelectObject-Funktion wählt ein Objekt im angegebenen Gerätekontext (DC) aus. Das neue Objekt ersetzt das vorherige Objekt desselben Typs.

Syntax

HGDIOBJ SelectObject(
  [in] HDC     hdc,
  [in] HGDIOBJ h
);

Parameter

[in] hdc

Ein Handle für den DC.

[in] h

Ein Handle für das objekt, das ausgewählt werden soll. Das angegebene Objekt muss mithilfe einer der folgenden Funktionen erstellt worden sein.

Object	Functions
Bitmap	CreateBitmap, CreateBitmapIndirect, CreateCompatibleBitmap, CreateDIBitmap, CreateDIBSection Bitmaps können nur in Speicher-DC's ausgewählt werden. Eine einzelne Bitmap kann nicht in mehreren DC gleichzeitig ausgewählt werden.
Brush	CreateBrushIndirect, CreateDIBPatternBrush, CreateDIBPatternBrushPt, CreateHatchBrush, CreatePatternBrush, CreateSolidBrush
Schriftart	CreateFont, CreateFontIndirect
Stift	CreatePen, CreatePenIndirect
Region	CombineRgn, CreateEllipticRgn, CreateEllipticRgnIndirect, CreatePolygonRgn, CreateRectRgn, CreateRectRgnIndirect

Rückgabewert

Wenn das ausgewählte Objekt keine Region ist und die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das zu ersetzende Objekt. Wenn das ausgewählte Objekt eine Region ist und die Funktion erfolgreich ist, ist der Rückgabewert einer der folgenden Werte.

Wert	Bedeutung
SIMPLEREGION	Die Region besteht aus einem einzelnen Rechteck.
COMPLEXREGION	Die Region besteht aus mehreren Rechtecken.
NULLREGION	Region ist leer.

Wenn ein Fehler auftritt und das ausgewählte Objekt keine Region ist, ist der Rückgabewert NULL. Andernfalls wird sie HGDI_ERROR.

Hinweise

Diese Funktion gibt das zuvor ausgewählte Objekt des angegebenen Typs zurück. Eine Anwendung sollte ein neues Objekt immer durch das ursprüngliche Standardobjekt ersetzen, nachdem die Zeichnung durch das neue Objekt abgeschlossen wurde.

Eine Anwendung kann keine einzelne Bitmap in mehr als einem DC gleichzeitig auswählen.

ICM: Wenn es sich bei dem ausgewählten Objekt um einen Pinsel oder Stift handelt, wird die Farbverwaltung durchgeführt.

Beispiele

Ein Beispiel finden Sie unter Festlegen der Stift- oder Pinselfarbe.

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