clear_rectangle ( : : Row1, Column1, Row2, Column2 : )

Deletion of a rectangle on the output window.

clear_rectangle deletes all entries in the rectangle, which is defined through the upper left corner (Row1,Column1) and the lower right corner (Row2,Column2). Deletion significates that the specified rectangle is set to the background color (see open_window, open_textwindow).

If you want to delete more than one rectangle, you may pass several rectangles, i.e. the parameters Row1, Column1, Row2 and Column2 are tupel each. If the corresponding window is not active yet, you may activate it by set_window.


Parameters

Row1 (input_control)
rectangle.origin.y(-array) -> integer
Line index of upper left corner.
Default value: 10
Range of values: 0 <= Row1 <= 511 (lin)
Minimum increment: 1
Recommended increment: 1

Column1 (input_control)
rectangle.origin.x(-array) -> integer
Column index of upper left corner.
Default value: 10
Range of values: 0 <= Column1 <= 511 (lin)
Minimum increment: 1
Recommended increment: 1

Row2 (input_control)
rectangle.corner.y(-array) -> integer
Row index of lower right corner.
Default value: 118
Range of values: 0 <= Row2 <= 511 (lin)
Minimum increment: 1
Recommended increment: 1
Restriction: Row2 > Row1

Column2 (input_control)
rectangle.corner.x(-array) -> integer
Column index of lower right corner.
Default value: 118
Range of values: 0 <= Column2 <= 511 (lin)
Minimum increment: 1
Recommended increment: 1
Restriction: Column2 >= Column1


Example
/* "Interaktives" Loeschen eines Rechtecks im Ausgabefenster: */
draw_rectangle1(:::L1,C1,L2,C2) >
clear_rectangle(::L1,C1,L2,C2:).

Result

If an ouputwindow exists and if the specified parameters are correct, then clear_rectangle returns TRUE. If necessary an exception is raised.


Possible Predecessors

open_window, set_draw, set_color, set_colored, set_line_width, set_rgb, set_hsi, set_window, draw_rectangle1


Alternatives

clear_window, disp_rectangle1


See also

open_window, open_textwindow, set_window



Copyright © 1996-1997 MVTec Software GmbH