This documentation was styled with a demo skin from the Premium Pack 4 add-on for Help & Manual. The contents of the skin are encrypted and not configurable. You can only publish HM projects with this skin. You cannot edit it or change it.
This version is copyright and may only be used for local testing purposes. It may not be distributed.
Please purchase the full version of the Premium Pack to get the configurable skins and remove this notice. The package will also include the Toolbox configuration utility for Premium Pack skins.
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