Xbasic

UI_SHAPE_DESTROY Function

Syntax

V UI_SHAPE_DESTROY(C shape)

Arguments

shape

The name of the shape to remove from memory.

Description

The UI_SHAPE_DESTROY() function removes the named shape from memory. The following functions create named shapes: UI_SHAPE_OVAL(), UI_SHAPE_RECT(), UI_SHAPE_ROUND_RECT(), and UI_SHAPE_START_POLY().

Example

The following example would otherwise draw two ovals, except that code deletes the first oval shape before drawing the second.

images/GR_ui_destroy_shape.gif
ui_bitmap_create("test", 4, 2)
ui_shape_oval("oval", 0, 0, 2, 1)
ui_bitmap_draw("test", <<%code%
inner_rect(0, 0, 4, 2)
set_brush("green")
fill_shape("oval", 1, .5)
ui_shape_destroy("oval")
fill_shape("oval", 0, .0)
%code%)
ui_dlg_box("", "{image=test}")

Limitations

This function is only used in the Code sections of UI_BITMAP_DRAW(), UI_SCREEN_DRAW(), and UI_PRINTER_DRAW().

See Also