move_rectangle ( : : Row1, Column1, Row2, Column2, DestRow, DestColumn : )

Copying inside an output window.

move_rectangle copies all entries in the rectangle (Row1,Column1), (Row2,Column2) of the current output window to a new position inside the same window. This position is determined by the upper left corner (DestRow, DestColumn). Regions of the window, which are "uncovered" through moving the rectangle, are set to the color of the background.

If you want to move several rectangles at once, you may pass parameters in form of tupels each. If the specified window is not already active yet before calling move_rectangle, you may activate it by set_window.


Parameters

Row1 (input_control)
rectangle.origin.y(-array) -> integer
Row index of upper left corner of the source rectangle.
Default value: 0
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 of the source rectangle.
Default value: 0
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 of the source rectangle.
Default value: 64
Range of values: 0 <= Row2 <= 511 (lin)
Minimum increment: 1
Recommended increment: 1

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

DestRow (input_control)
point.y(-array) -> integer
Row index of upper left corner of the target position.
Default value: 64
Range of values: 0 <= DestRow <= 511 (lin)
Minimum increment: 1
Recommended increment: 1

DestColumn (input_control)
point.x(-array) -> integer
Column index of upper left corner of the target position.
Default value: 64
Range of values: 0 <= DestColumn <= 511 (lin)
Minimum increment: 1
Recommended increment: 1


Example
/* "Interaktives" Kopieren eines Rechtecks im Ausgabefenster: */
draw_rectangle1(:::L1,C1,L2,C2) >
get_mbutton(:::LN,CN,Button) >
move_rectangle(::L1,C1,L2,C2,LN,CN:).

Result

If a window is activated and if the specified parameters are correct, then move_rectangle returns TRUE. If necessary an exception is raised.


Possible Predecessors

open_window, open_textwindow, set_window


Alternatives

copy_rectangle


See also

open_window, open_textwindow, set_window



Copyright © 1996-1997 MVTec Software GmbH