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
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

GetStockObject

Windows Mobile 6.5
A version of this page is also available for
4/8/2010

This function retrieves a handle to one of the predefined stock pens, brushes or fonts.


HGDIOBJ GetStockObject(
  int fnObject
); 

fnObject

[in] Specifies the type of stock object. It is one of the following values.

Value Description

BLACK_BRUSH

Black brush.

DKGRAY_BRUSH

Dark gray brush.

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.

WHITE_PEN

White pen.

NULL_PEN

Null pen.

SYSTEM_FONT

System font.

By default, the system uses the system font to draw menus, dialog box controls, and text.

DEFAULT_PALETTE

Default palette.

This palette consists of the static colors in the system palette.

Windows CE 1.0 and 1.01 do not support this value.

If the function succeeds, the return value identifies the logical object requested. NULL indicates failure. 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.

It is not necessary (but it is not harmful) to delete stock objects by calling DeleteObject.

Headerwindows.h
Librarycoredll.lib
Windows Embedded CEWindows CE 1.0 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions

Show:
© 2015 Microsoft