DeleteObject Method (DeviceContext)

In This Topic

Deletes a logical pen, brush, font, bitmap, region, or palette, freeing all system resources associated with the object. After the object is deleted, the specified handle is no longer valid.

Syntax

Visual Basic
C#

'Declaration
 
Public Shared Sub DeleteObject( _
   ByVal gdiObjectHandle As IntPtr _
)

public static void DeleteObject( 
   IntPtr gdiObjectHandle
)

Parameters

gdiObjectHandle: Handle to a logical pen, brush, font, bitmap, region, or palette.

Exceptions

Exception	Description
C1.Framework.SystemErrorException	If the specified handle is not valid or is currently selected into a DC, it would throw a C1.Framework.SystemErrorException.

Remarks

Do not delete a drawing object (pen or brush) while it is still selected into a DC. When a pattern brush is deleted, the bitmap associated with the brush is not deleted. The bitmap must be deleted independently.

Reference

DeviceContext Class
DeviceContext Members