Freigeben über


GetStockObject-Funktion (wingdi.h)

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

Weitere Informationen

DeleteObject

Gerätekontextfunktionen

Übersicht über Gerätekontexte

Auswählenobjekt