Share via


Gdi::DeleteObject_I (Windows CE 5.0)

Send Feedback

This method deletes a logical pen, brush, font, bitmap, region, or palette, freeing all system resources associated with the object. After Gdi::DeleteObject_I deletes the object, the specified handle is no longer valid.

static WINGDIAPI BOOL WINAPI DeleteObject_I(HGDIOBJ hgdiobj);

Parameters

  • hgdiobj
    [in] Handle to a logical pen, brush, font, bitmap, region, or palette.

Return Values

Nonzero indicates success.

Zero indicates that the specified handle is not valid or that the handle is currently selected into a device context.

To get extended error information, call GetLastError.

Remarks

This method is an internal version of the DeleteObject function.

Do not delete a drawing object, such as a pen or brush, while you still have the object selected into a device context.

When you delete a pattern brush, the bitmap associated with the brush is not deleted. You must delete the bitmap independently.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Gdi.hpp.

See Also

Gdi | DeleteObject | Gdi::SelectObject_I

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.