GetStockObject-Funktion (wingdi.h)

Artikel
08/27/2023

Die GetStockObject-Funktion ruft ein Handle für einen der Stock-Stifte, Pinsel, Schriftarten oder Paletten ab.

Syntax

HGDIOBJ GetStockObject(
  [in] int i
);

Parameter

[in] i

Der Typ des Bestandsobjekts. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
BLACK_BRUSH	Schwarzer Pinsel.
DKGRAY_BRUSH	Dunkelgrauer Pinsel.
DC_BRUSH	Volltonpinsel. Die Standardfarbe ist Weiß. Die Farbe kann mithilfe der SetDCBrushColor-Funktion geändert werden. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.
GRAY_BRUSH	Grauer Pinsel.
HOLLOW_BRUSH	Hohlpinsel (entspricht NULL_BRUSH).
LTGRAY_BRUSH	Hellgrauer Pinsel.
NULL_BRUSH	NULL-Pinsel (entspricht HOLLOW_BRUSH).
WHITE_BRUSH	Weißer Pinsel.
BLACK_PEN	Schwarzer Stift.
DC_PEN	Einfarbige Stiftfarbe. Die Standardfarbe ist Schwarz. Die Farbe kann mithilfe der SetDCPenColor-Funktion geändert werden. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.
NULL_PEN	Null-Stift. Der NULL-Stift zeichnet nichts.
WHITE_PEN	Weißer Stift.
ANSI_FIXED_FONT	Windows-Systemschriftart mit fester Tonhöhe (Monospace).
ANSI_VAR_FONT	Windows-Systemschriftart mit variabler Tonhöhe (proportionaler Abstand).
DEVICE_DEFAULT_FONT	Geräteabhängige Schriftart.
DEFAULT_GUI_FONT	Standardschriftart für Benutzeroberflächenobjekte wie Menüs und Dialogfelder. Es wird nicht empfohlen, DEFAULT_GUI_FONT oder SYSTEM_FONT zu verwenden, um die Schriftart abzurufen, die von Dialogfeldern und Fenstern verwendet wird. Weitere Informationen finden Sie im Abschnitt "Hinweise". Die Standardschriftart ist Tahoma.
OEM_FIXED_FONT	Original Equipment Manufacturer (OEM) abhängige Schriftart mit fester Tonhöhe (Monospace).
SYSTEM_FONT	Systemschriftart. Standardmäßig verwendet das System die Systemschriftart, um Menüs, Dialogfeldsteuerelemente und Text zu zeichnen. Es wird nicht empfohlen, DEFAULT_GUI_FONT oder SYSTEM_FONT zu verwenden, um die Schriftart abzurufen, die von Dialogfeldern und Fenstern verwendet wird. Weitere Informationen finden Sie im Abschnitt "Hinweise". Die Standardschriftart des Systems ist Tahoma.
SYSTEM_FIXED_FONT	Systemschriftart mit fester Neigung (Monospace). Dieses Bestandsobjekt wird nur zur Kompatibilität mit 16-Bit-Windows-Versionen vor 3.0 bereitgestellt.
DEFAULT_PALETTE	Standardpalette. Diese Palette besteht aus den statischen Farben in der Systempalette.

Rückgabewert

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

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

Hinweise

Es wird nicht empfohlen, diese Methode zu verwenden, um die aktuelle Schriftart abzurufen, die von Dialogfeldern und Fenstern verwendet wird. Verwenden Sie stattdessen die SystemParametersInfo-Funktion mit dem parameter SPI_GETNONCLIENTMETRICS, um die aktuelle Schriftart abzurufen. SystemParametersInfo berücksichtigt das aktuelle Design und stellt Schriftartinformationen für Beschriftungen, Menüs und Nachrichtendialoge bereit.

Verwenden Sie die objekte DKGRAY_BRUSH, GRAY_BRUSH und LTGRAY_BRUSH nur in Fenstern mit den Stilen CS_HREDRAW und CS_VREDRAW. Die Verwendung eines grauen Stockpinsels in einem anderen Fensterstil kann zu einer falschen Ausrichtung von Pinselmustern führen, nachdem ein Fenster verschoben oder dimensioniert wurde. Die Ursprünge von Stockpinsel können nicht angepasst werden.

Die HOLLOW_BRUSH- und NULL_BRUSH Stock-Objekte sind gleichwertig.

Es ist nicht notwendig (aber es ist nicht schädlich), bestandsbestande Objekte durch Aufrufen von DeleteObject zu löschen.

Sowohl DC_BRUSH als auch DC_PEN können austauschbar mit anderen Bestandsobjekten wie BLACK_BRUSH und BLACK_PEN verwendet werden. Informationen zum Abrufen der aktuellen Stift- oder Pinselfarbe finden Sie unter GetDCBrushColor und GetDCPenColor. Ein Beispiel für das Festlegen von Farben finden Sie unter Festlegen der Stift- oder Pinselfarbe . Die GetStockObject-Funktion mit dem Argument DC_BRUSH oder DC_PEN kann austauschbar mit den Funktionen SetDCPenColor und SetDCBrushColor verwendet werden.

Beispiele

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

Anforderungen


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 (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll