SelectObject

Description

The SelectObject function selects an object into the specified device context (DC). The new object replaces the previous object of the same type.

Syntax

HGDIOBJ SelectObject(
  _In_  HDC     hdc,
  _In_  HGDIOBJ hgdiobj
);

Parameters

hdc [in]

A handle to the DC.

hgdiobj [in]

A handle to the object to be selected. The specified object must have been created by using one of the following functions.

Object	Functions
Bitmap	CreateBitmap, CreateBitmapIndirect, CreateCompatibleBitmap, CreateDIBitmap, CreateDIBSection Bitmaps can only be selected into memory DC's. A single bitmap cannot be selected into more than one DC at the same time.
Brush	CreateBrushIndirect, CreateDIBPatternBrush, CreateDIBPatternBrushPt, CreateHatchBrush, CreatePatternBrush, CreateSolidBrush
Font	CreateFont, CreateFontIndirect
Pen	CreatePen, CreatePenIndirect
Region	CombineRgn, CreateEllipticRgn, CreateEllipticRgnIndirect, CreatePolygonRgn, CreateRectRgn, CreateRectRgnIndirect

Return value

If the selected object is not a region and the function succeeds, the return value is a handle to the object being replaced. If the selected object is a region and the function succeeds, the return value is one of the following values.

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

If an error occurs and the selected object is not a region, the return value is NULL. Otherwise, it is HGDI_ERROR.