windows_programming_notes.nbk: Home | Index | Next Page: Sending A Message | Previous Page: SCROLLINFO

 SelectObject

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(
      HDC hdc,          // handle to DC
      HGDIOBJ hgdiobj   // handle to object
    );

Parameters

• hdc
  [in] Handle to the DC.
• hgdiobj ;;[in]
  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 be selected for memory DCs only, and for only one DC at a time.) Brush [CreateBrushIndirect], [CreateDIBPatternBrush], [CreateDIBPatternBrushPt], [CreateHatchBrush], [CreatePatternBrush], CreateSolidBrush Font CreateFont, [CreateFontIndirect] Pen CreatePen, [CreatePenIndirect] Region [CombineRgn], [CreateEllipticRgn], [CreateEllipticRgnIndirect], [CreatePolygonRgn], [CreateRectRgn], [CreateRectRgnIndirect]

Return Values

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.

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 DC at a time.

ICM: If the object being selected is a brush or a pen, color management is performed.

Requirements

• Windows NT/2000/XP/Vista: Included in Windows NT 3.1 and later.
• Windows 95/98/Me: Included in Windows 95 and later.
• Header: Declared in Wingdi.h; include Windows.h.
• Library: Use Gdi32.lib.

windows_programming_notes.nbk: Home | Index | Next Page: Sending A Message | Previous Page: SCROLLINFO

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time