|
<< Click to Display Table of Contents >> Navigation: ThinBASIC Modules > UI (User Interface) > Windows API > Win_DeleteObject |
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