Navigation:  thinBasic Modules > UI (User Interface) > Windows >

Win_DeleteObject

Previous pageReturn to chapter overviewNext page

 

Description

 

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

 

n = Win_DeleteObject(hObj)

 

Returns

 

Number.

 

Parameters

 

Name

Type

Optional

Meaning

hObj

Number

No

A handle to a logical pen, brush, font, bitmap, region, or palette.

 

Remarks

 

If the function succeeds, the return value is nonzero.

If the specified handle is not valid or is currently selected into a DC, the return value is zero.

 

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.

 

Restrictions

 

See also

 

Examples