clear_rectangleT_clear_rectangleClearRectangleClearRectangleclear_rectangle (Operator)
名称
clear_rectangleT_clear_rectangleClearRectangleClearRectangleclear_rectangle — 删除输出窗口上的矩形。
警告
clear_rectangleclear_rectangleClearRectangleClearRectangleClearRectangleclear_rectangle is obsolete and is only provided for
reasons of backward compatibility.
签名
void ClearRectangle(const HTuple& WindowHandle, const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2)
void HWindow::ClearRectangle(const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2) const
void HWindow::ClearRectangle(Hlong Row1, Hlong Column1, Hlong Row2, Hlong Column2) const
static void HOperatorSet.ClearRectangle(HTuple windowHandle, HTuple row1, HTuple column1, HTuple row2, HTuple column2)
void HWindow.ClearRectangle(HTuple row1, HTuple column1, HTuple row2, HTuple column2)
void HWindow.ClearRectangle(int row1, int column1, int row2, int column2)
描述
clear_rectangleclear_rectangleClearRectangleClearRectangleClearRectangleclear_rectangle deletes all entries in the rectangle which
is defined through the upper left corner
(Row1Row1Row1Row1row1row_1,Column1Column1Column1Column1column1column_1) and the lower right corner
(Row2Row2Row2Row2row2row_2,Column2Column2Column2Column2column2column_2). Deletion means that the
specified rectangle is set to the background color (see
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window).
If you want to delete more than one rectangle, you may pass several
rectangles, i.e., the parameters Row1Row1Row1Row1row1row_1, Column1Column1Column1Column1column1column_1,
Row2Row2Row2Row2row2row_2 and Column2Column2Column2Column2column2column_2 are tuples.
执行信息
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
参数
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)
Line index of upper left corner.
默认值:
10
值范围:
0
≤
Row1
Row1
Row1
Row1
row1
row_1
≤
511 (lin)
最小增量:
1
建议增量:
1
Column1Column1Column1Column1column1column_1 (input_control) rectangle.origin.x(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Column index of upper left corner.
默认值:
10
值范围:
0
≤
Column1
Column1
Column1
Column1
column1
column_1
≤
511 (lin)
最小增量:
1
建议增量:
1
Row2Row2Row2Row2row2row_2 (input_control) rectangle.corner.y(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Row index of lower right corner.
默认值:
118
值范围:
0
≤
Row2
Row2
Row2
Row2
row2
row_2
≤
511 (lin)
最小增量:
1
建议增量:
1
限制:
Row2 > Row1
Column2Column2Column2Column2column2column_2 (input_control) rectangle.corner.x(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Column index of lower right corner.
默认值:
118
值范围:
0
≤
Column2
Column2
Column2
Column2
column2
column_2
≤
511 (lin)
最小增量:
1
建议增量:
1
限制:
Column2 >= Column1
示例(HDevelop)
* Erase a rectangle in the output window interactively:
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
示例(C)
/* Erase a rectangle in the output window interactively: */
draw_rectangle1(WindowHandle,&L1,&C1,&L2,&C2);
示例(HDevelop)
* Erase a rectangle in the output window interactively:
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
示例(HDevelop)
* Erase a rectangle in the output window interactively:
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
示例(HDevelop)
* Erase a rectangle in the output window interactively:
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
结果
If an output window exists and the specified parameters are correct
clear_rectangleclear_rectangleClearRectangleClearRectangleClearRectangleclear_rectangle returns 2 (
H_MSG_TRUE)
.
If necessary an exception is raised.
可能的前置算子
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window,
set_drawset_drawSetDrawSetDrawSetDrawset_draw,
set_colorset_colorSetColorSetColorSetColorset_color,
set_coloredset_coloredSetColoredSetColoredSetColoredset_colored,
set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidthset_line_width,
set_rgbset_rgbSetRgbSetRgbSetRgbset_rgb,
set_hsiset_hsiSetHsiSetHsiSetHsiset_hsi,
draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1DrawRectangle1draw_rectangle1
替代算子
clear_windowclear_windowClearWindowClearWindowClearWindowclear_window,
disp_rectangle1disp_rectangle1DispRectangle1DispRectangle1DispRectangle1disp_rectangle1
另见
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window
模块
Foundation