GetCurrentObject

The GetCurrentObject function obtains a handle to a device context's currently selected object of a specified type.

HGDIOBJ GetCurrentObject(
  HDC hdc,           // handle to device context
  UINT uObjectType   // specifies the object-type
);
 

Parameters

hdc

Handle to the device context.

uObjectType

Specifies the object type to be queried. This parameter can be one of the following values:

Value	Meaning
OBJ_PEN	Returns the current selected pen.
OBJ_BRUSH	Returns the current selected brush.
OBJ_PAL	Returns the current selected palette.
OBJ_FONT	Returns the current selected font.
OBJ_BITMAP	Returns the current selected bitmap.

Return Values

If the function succeeds, the return value is the handle of the specified object.

If the function fails, the return value is NULL.

Windows NT: To get extended error information, call GetLastError.

Remarks

An application can use the GetCurrentObject and GetObject functions to retrieve descriptions of the graphic objects currently selected into the given device context.

Windows CE: Windows CE version 1.0 does not support the OBJ_PAL flag value for the uObjectType parameter.

In Windows CE version 2.0, this function is exactly the same as it is in Windows desktop platforms.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Requires version 1.0 or later.
  Header: Declared in wingdi.h.
  Import Library: Use gdi32.lib.

See Also

Device Contexts Overview, Device Context Functions, DeleteObject, GetObject, SelectObject