Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Collapse the table of content
Expand the table of content


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