The GetStockObject function retrieves a handle to one of the predefined stock pens, brushes, fonts, or palettes.
HGDIOBJ GetStockObject(
int fnObject // type of stock object
);
| Value | Meaning |
|---|---|
| BLACK_BRUSH | Black brush. |
| DKGRAY_BRUSH | Dark gray brush. |
| DC_BRUSH | Windows 98, Windows NT 5.0 and later: Solid color brush. The default color is white. The color can be changed by using the SetDCBrushColor function. For more information, see the following Remarks section. |
| GRAY_BRUSH | Gray brush. |
| HOLLOW_BRUSH | Hollow brush (equivalent to NULL_BRUSH). |
| LTGRAY_BRUSH | Light gray brush. |
| NULL_BRUSH | Null brush (equivalent to HOLLOW_BRUSH). |
| WHITE_BRUSH | White brush. |
| BLACK_PEN | Black pen. |
| DC_PEN | Windows 98, Windows NT 5.0 and later: Solid pen color. The default color is white. The color can be changed by using the SetDCPenColor function. For more information, see the following Remarks section. |
| WHITE_PEN | White pen. |
| ANSI_FIXED_FONT | Windows fixed-pitch (monospace) system font. |
| ANSI_VAR_FONT | Windows variable-pitch (proportional space) system font. |
| DEVICE_DEFAULT_FONT | Windows NT: Device-dependent font. |
| DEFAULT_GUI_FONT | Default font for user interface objects such as menus and dialog boxes. |
| OEM_FIXED_FONT | Original equipment manufacturer (OEM) dependent fixed-pitch (monospace) font. |
| SYSTEM_FONT | System font. By default, the system uses the system font to draw menus, dialog box controls, and text. |
| SYSTEM_FIXED_FONT | Fixed-pitch (monospace) system font. This stock object is provided only for compatibility with 16-bit Windows versions earlier than 3.0. |
| DEFAULT_PALETTE | Default palette. This palette consists of the static colors in the system palette. |
If the function succeeds, the return value identifies the logical object requested.
If the function fails, the return value is NULL.
Windows NT: To get extended error information, call GetLastError.
Use the DKGRAY_BRUSH, GRAY_BRUSH, and LTGRAY_BRUSH stock objects only in windows with the CS_HREDRAW and CS_VREDRAW styles. Using a gray stock brush in any other style of window can lead to misalignment of brush patterns after a window is moved or sized. The origins of stock brushes cannot be adjusted.
The HOLLOW_BRUSH and NULL_BRUSH stock objects are equivalent.
The font used by the DEFAULT_GUI_FONT stock object could change. Use this stock object when you want to use the font that menus, dialog boxes, and other user interface objects use.
It is not necessary (but it is not harmful) to delete stock objects by calling DeleteObject.
Windows 98, Windows NT 5.0 and later: Both DC_BRUSH and DC_PEN can be used interchangeably with other stock objects like BLACK_BRUSH and BLACK_PEN. For information on retrieving the current pen or brush color, see GetDCBrushColor and GetDCPenColor. See Setting the Pen or Brush Color for an example of setting colors. The GetStockObject function with an argument of DC_BRUSH OR DC_PEN can be used interchangeably with the SetDCPenColor and SetDCBrushColor functions.
Windows CE: Windows CE does not support the following values for the fnObject parameter.
ANSI_FIXED_FONT
ANSI_VAR_FONT
OEM_FIXED_FONT
SYSTEM_FIXED_FONT
Windows CE version 1.0 does not support the DEFAULT_PALETTE value for fnObject.
Windows NT: Requires version 3.1 or later.
Windows: Requires Windows 95 or later.
Windows CE: Requires version 1.0 or later.
Header: Declared in wingdi.h.
Import Library: Use gdi32.lib.
Device Contexts Overview, Device Context Functions, DeleteObject, SelectObject