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 |
|---|---|
|
Schwarzer Pinsel. |
|
Dunkelgrauer Pinsel. |
|
Volltonpinsel. Die Standardfarbe ist Weiß. Die Farbe kann mithilfe der SetDCBrushColor-Funktion geändert werden. Weitere Informationen finden Sie im Abschnitt mit Hinweisen. |
|
Grauer Pinsel. |
|
Hohlpinsel (entspricht NULL_BRUSH). |
|
Hellgrauer Pinsel. |
|
NULL-Pinsel (entspricht HOLLOW_BRUSH). |
|
Weißer Pinsel. |
|
Schwarzer Stift. |
|
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-Stift. Der NULL-Stift zeichnet nichts. |
|
Weißer Stift. |
|
Windows-Systemschriftart mit fester Tonhöhe (Monospace). |
|
Windows-Systemschriftart mit variabler Tonhöhe (proportionaler Abstand). |
|
Geräteabhängige Schriftart. |
|
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. |
|
Original Equipment Manufacturer (OEM) abhängige Schriftart mit fester Tonhöhe (Monospace). |
|
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. |
|
Systemschriftart mit fester Neigung (Monospace). Dieses Bestandsobjekt wird nur zur Kompatibilität mit 16-Bit-Windows-Versionen vor 3.0 bereitgestellt. |
|
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 |