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.
Bitmaps can only be selected into memory DC's. A single bitmap cannot be selected into more than one DC at the same time.
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)|