Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize


Selects a CGdiObject object that corresponds to one of the predefined stock pens, brushes, or fonts.

virtual CGdiObject* SelectStockObject( 
   int nIndex  


Specifies the kind of stock object desired. It can be one of the following values:

  • BLACK_BRUSH   Black brush.

  • DKGRAY_BRUSH   Dark gray brush.

  • GRAY_BRUSH   Gray brush.

  • HOLLOW_BRUSH   Hollow brush.

  • LTGRAY_BRUSH   Light gray brush.

  • NULL_BRUSH   Null brush.

  • WHITE_BRUSH   White brush.

  • BLACK_PEN   Black pen.

  • NULL_PEN   Null pen.

  • WHITE_PEN   White pen.

  • ANSI_FIXED_FONT   ANSI fixed system font.

  • ANSI_VAR_FONT   ANSI variable system font.

  • DEVICE_DEFAULT_FONT   Device-dependent font.

  • OEM_FIXED_FONT   OEM-dependent fixed font.

  • SYSTEM_FONT   The system font. By default, Windows uses the system font to draw menus, dialog-box controls, and other text. It is best, however, not to rely on SYSTEM_FONT to obtain the font used by dialogs and windows. Instead, use the SystemParametersInfo function with the SPI_GETNONCLIENTMETRICS parameter to retrieve the current font. SystemParametersInfo takes into account the current theme and provides font information for captions, menus, and message dialogs.

  • SYSTEM_FIXED_FONT   The fixed-width system font used in Windows prior to version 3.0. This object is available for compatibility with earlier versions of Windows.

  • DEFAULT_PALETTE   Default color palette. This palette consists of the 20 static colors in the system palette.

A pointer to the CGdiObject object that was replaced if the function is successful. The actual object pointed to is a CPen, CBrush, or CFont object. If the call is unsuccessful, the return value is NULL.

Header: afxwin.h

© 2015 Microsoft