SelectObject function (wingdi.h)
The SelectObject function selects an object into the specified device context (DC). The new object replaces the previous object of the same type.
HGDIOBJ SelectObject( [in] HDC hdc, [in] HGDIOBJ h );
A handle to the DC.
A handle to the object to be selected. The specified object must have been created by using one of the following functions.
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.
CreateBrushIndirect, CreateDIBPatternBrush, CreateDIBPatternBrushPt, CreateHatchBrush, CreatePatternBrush, CreateSolidBrush
CombineRgn, CreateEllipticRgn, CreateEllipticRgnIndirect, CreatePolygonRgn, CreateRectRgn, CreateRectRgnIndirect
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.
|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.
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 single bitmap into more than one DC at a time.
ICM: If the object being selected is a brush or a pen, color management is performed.
For an example, see Setting the Pen or Brush Color.
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|
|Header||wingdi.h (include Windows.h)|