8/28/2008 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
);
- hdc
-
[in] Handle to the device context.
- hgdiobj
-
[in] Handle to the object to be selected.
The specified object must have been created by using one of the following functions.
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.
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.
| Header | windows.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
Reference
CombineRgn
CreateBitmap
CreateCompatibleBitmap
CreateDIBPatternBrushPt
CreateDIBSection
CreatePatternBrush
CreatePen
CreatePenIndirect
CreateRectRgn
CreateRectRgnIndirect
CreateSolidBrush
SelectClipRgn
GDI Functions
Other Resources
CreateFontIndirect