move_rectangleT_move_rectangleMoveRectangleMoveRectanglemove_rectangle (Operator)
Name
move_rectangleT_move_rectangleMoveRectangleMoveRectanglemove_rectangle — Copy inside an output window.
Warning
move_rectanglemove_rectangleMoveRectangleMoveRectangleMoveRectanglemove_rectangle is obsolete and is only provided for
reasons of backward compatibility.
Signature
void MoveRectangle(const HTuple& WindowHandle, const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2, const HTuple& DestRow, const HTuple& DestColumn)
void HWindow::MoveRectangle(const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2, const HTuple& DestRow, const HTuple& DestColumn) const
void HWindow::MoveRectangle(Hlong Row1, Hlong Column1, Hlong Row2, Hlong Column2, Hlong DestRow, Hlong DestColumn) const
static void HOperatorSet.MoveRectangle(HTuple windowHandle, HTuple row1, HTuple column1, HTuple row2, HTuple column2, HTuple destRow, HTuple destColumn)
void HWindow.MoveRectangle(HTuple row1, HTuple column1, HTuple row2, HTuple column2, HTuple destRow, HTuple destColumn)
void HWindow.MoveRectangle(int row1, int column1, int row2, int column2, int destRow, int destColumn)
Description
move_rectanglemove_rectangleMoveRectangleMoveRectangleMoveRectanglemove_rectangle copies all entries in the rectangle
(Row1Row1Row1Row1row1row_1,Column1Column1Column1Column1column1column_1), (Row2Row2Row2Row2row2row_2,Column2Column2Column2Column2column2column_2)
of the output window to a new position inside the same window.
This position is determined by the upper left corner (DestRowDestRowDestRowDestRowdestRowdest_row,
DestColumnDestColumnDestColumnDestColumndestColumndest_column).
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 tuples.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Window handle.
Row1Row1Row1Row1row1row_1 (input_control) rectangle.origin.y(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Row index of upper left corner of the source rectangle.
Default value: 0
Typical range of values: 0
≤
Row1
Row1
Row1
Row1
row1
row_1
≤
511 (lin)
Minimum increment: 1
Recommended increment: 1
Column1Column1Column1Column1column1column_1 (input_control) rectangle.origin.x(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Column index of upper left corner of the source rectangle.
Default value: 0
Typical range of values: 0
≤
Column1
Column1
Column1
Column1
column1
column_1
≤
511 (lin)
Minimum increment: 1
Recommended increment: 1
Row2Row2Row2Row2row2row_2 (input_control) rectangle.corner.y(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Row index of lower right corner of the source rectangle.
Default value: 64
Typical range of values: 0
≤
Row2
Row2
Row2
Row2
row2
row_2
≤
511 (lin)
Minimum increment: 1
Recommended increment: 1
Column2Column2Column2Column2column2column_2 (input_control) rectangle.corner.x(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Column index of lower right corner of the source rectangle.
Default value: 64
Typical range of values: 0
≤
Column2
Column2
Column2
Column2
column2
column_2
≤
511 (lin)
Minimum increment: 1
Recommended increment: 1
DestRowDestRowDestRowDestRowdestRowdest_row (input_control) point.y(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Row index of upper left corner of the target position.
Default value: 64
Typical range of values: 0
≤
DestRow
DestRow
DestRow
DestRow
destRow
dest_row
≤
511 (lin)
Minimum increment: 1
Recommended increment: 1
DestColumnDestColumnDestColumnDestColumndestColumndest_column (input_control) point.x(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Column index of upper left corner of the target position.
Default value: 64
Typical range of values: 0
≤
DestColumn
DestColumn
DestColumn
DestColumn
destColumn
dest_column
≤
511 (lin)
Minimum increment: 1
Recommended increment: 1
Example (HDevelop)
* "Interactive" copy of a rectangle in the same window
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
get_mbutton(WindowHandle,LN,CN,Button)
move_rectangle(WindowHandle,L1,C1,L2,C2,LN,CN)
Example (C)
/* "Interactive" copy of a rectangle in the same window */
draw_rectangle1(WindowHandle,&L1,&C1,&L2,&C2);
get_mbutton(WindowHandle,LN,CN,NULL);
move_rectangle(WindowHandle,L1,C1,L2,C2,LN,CN);
Example (HDevelop)
* "Interactive" copy of a rectangle in the same window
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
get_mbutton(WindowHandle,LN,CN,Button)
move_rectangle(WindowHandle,L1,C1,L2,C2,LN,CN)
Example (HDevelop)
* "Interactive" copy of a rectangle in the same window
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
get_mbutton(WindowHandle,LN,CN,Button)
move_rectangle(WindowHandle,L1,C1,L2,C2,LN,CN)
Example (HDevelop)
* "Interactive" copy of a rectangle in the same window
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
get_mbutton(WindowHandle,LN,CN,Button)
move_rectangle(WindowHandle,L1,C1,L2,C2,LN,CN)
Result
If the window is valid and the specified parameters are correct
move_rectanglemove_rectangleMoveRectangleMoveRectangleMoveRectanglemove_rectangle returns 2 (H_MSG_TRUE).
If necessary an exception is raised.
Possible Predecessors
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window
Alternatives
copy_rectanglecopy_rectangleCopyRectangleCopyRectangleCopyRectanglecopy_rectangle
See also
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window
Module
Foundation