Share via


SelectObject

This function selects an object into a specified device context. The new object replaces the previous object of the same type.

HGDIOBJ SelectObject(
  HDC hdc, 
  HGDIOBJ hgdiobj
); 

Parameters

Return Values

If the selected object is not a region, the handle of the object being replaced indicates success. If the selected object is a region, one of the following values indicates success.

Value Description
SIMPLEREGION Region consists of a single rectangle.
COMPLEXREGION Region consists of more than one rectangle.
NULLREGION Region is empty.

NULL indicates that an error occurred and the selected object is not a region. Otherwise, a GDI_ERROR value is returned.

Remarks

This function returns the previously selected object of the specified type. An application should always replace a new object with the original, default object after it has finished drawing with the new object.

An application cannot select a bitmap into more than one device context at a time.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Windows.h.
Link Library: Coredll.lib.

See Also

CombineRgn | CreateBitmap | CreateCompatibleBitmap | CreateDIBPatternBrushPt | CreateDIBSection | CreateFontIndirect | CreatePatternBrush | CreatePen | CreatePenIndirect | CreateRectRgn | CreateRectRgnIndirect | CreateSolidBrush | SelectClipRgn | GDI Functions

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.