Skip to content

move_rectangleMoveRectangleMoveRectanglemove_rectangleT_move_rectangle🔗

Short description🔗

move_rectangleMoveRectangleMoveRectanglemove_rectangleT_move_rectangle — Copy inside an output window.

Warning🔗

move_rectangleMoveRectangle is obsolete and is only provided for reasons of backward compatibility.

Signature🔗

move_rectangle( window WindowHandle, rectangle.origin.y Row1, rectangle.origin.x Column1, rectangle.corner.y Row2, rectangle.corner.x Column2, point.y DestRow, point.x DestColumn )void MoveRectangle( const HTuple& WindowHandle, const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2, const HTuple& DestRow, const HTuple& DestColumn )static void HOperatorSet.MoveRectangle( HTuple windowHandle, HTuple row1, HTuple column1, HTuple row2, HTuple column2, HTuple destRow, HTuple destColumn )def move_rectangle( window_handle: HHandle, row_1: MaybeSequence[int], column_1: MaybeSequence[int], row_2: MaybeSequence[int], column_2: MaybeSequence[int], dest_row: MaybeSequence[int], dest_column: MaybeSequence[int] ) -> None

Herror T_move_rectangle( 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

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_rectangleMoveRectangle copies all entries in the rectangle (Row1row1row_1,Column1column1column_1), (Row2row2row_2,Column2column2column_2) of the output window to a new position inside the same window. This position is determined by the upper left corner (DestRowdestRowdest_row, DestColumndestColumndest_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🔗

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🔗

WindowHandlewindowHandlewindow_handle (input_control) window → (handle)HTuple (HHandle)HWindow, HTuple (IntPtr)HHandleHtuple (handle)

Window handle.

Row1row1row_1 (input_control) rectangle.origin.y(-array) → (integer)HTuple (Hlong)HTuple (int / long)MaybeSequence[int]Htuple (Hlong)

Row index of upper left corner of the source rectangle.

Default: 00
Value range: 0 ≤ Row1 ≤ 511 (lin)
Minimum increment: 1
Recommended increment: 1

Column1column1column_1 (input_control) rectangle.origin.x(-array) → (integer)HTuple (Hlong)HTuple (int / long)MaybeSequence[int]Htuple (Hlong)

Column index of upper left corner of the source rectangle.

Default: 00
Value range: 0 ≤ Column1 ≤ 511 (lin)
Minimum increment: 1
Recommended increment: 1

Row2row2row_2 (input_control) rectangle.corner.y(-array) → (integer)HTuple (Hlong)HTuple (int / long)MaybeSequence[int]Htuple (Hlong)

Row index of lower right corner of the source rectangle.

Default: 6464
Value range: 0 ≤ Row2 ≤ 511 (lin)
Minimum increment: 1
Recommended increment: 1

Column2column2column_2 (input_control) rectangle.corner.x(-array) → (integer)HTuple (Hlong)HTuple (int / long)MaybeSequence[int]Htuple (Hlong)

Column index of lower right corner of the source rectangle.

Default: 6464
Value range: 0 ≤ Column2 ≤ 511 (lin)
Minimum increment: 1
Recommended increment: 1

DestRowdestRowdest_row (input_control) point.y(-array) → (integer)HTuple (Hlong)HTuple (int / long)MaybeSequence[int]Htuple (Hlong)

Row index of upper left corner of the target position.

Default: 6464
Value range: 0 ≤ DestRow ≤ 511 (lin)
Minimum increment: 1
Recommended increment: 1

DestColumndestColumndest_column (input_control) point.x(-array) → (integer)HTuple (Hlong)HTuple (int / long)MaybeSequence[int]Htuple (Hlong)

Column index of upper left corner of the target position.

Default: 6464
Value range: 0 ≤ DestColumn ≤ 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)
(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)\;

Result🔗

If the window is valid and the specified parameters are correct move_rectangleMoveRectangle returns 2 (H_MSG_TRUE). If necessary an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

open_windowOpenWindow

Alternatives

copy_rectangleCopyRectangle

See also

open_windowOpenWindow

Module🔗

Foundation