clear_rectangleT_clear_rectangleClearRectangleClearRectangle (Operator)
Name
clear_rectangleT_clear_rectangleClearRectangleClearRectangle — Löschen eines Rechtecks auf dem Ausgabefenster.
Warnung
clear_rectangleclear_rectangleClearRectangleClearRectangleClearRectangle ist veraltet und wird nur aus Gründen
der Rückwärtskompatibilität zur Verfügung gestellt.
Signatur
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)
Beschreibung
clear_rectangleclear_rectangleClearRectangleClearRectangleClearRectangle löscht alle Einträge in dem Rechteck, das
durch die linke obere Ecke (Row1Row1Row1Row1row1,Column1Column1Column1Column1column1) und die
rechte untere Ecke (Row2Row2Row2Row2row2,Column2Column2Column2Column2column2) aufgespannt
wird. Löschen bedeutet, dass das angegebene Rechteck auf die
Hintergrundfarbe gesetzt wird (siehe open_windowopen_windowOpenWindowOpenWindowOpenWindow).
Falls mehr als ein Rechteck gelöscht werden soll, können auch
mehrere Rechtecke übergeben werden, d.h. die Parameter
Row1Row1Row1Row1row1, Column1Column1Column1Column1column1, Row2Row2Row2Row2row2 und Column2Column2Column2Column2column2
sind jeweils Tupel.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control) window → HWindow, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Fenster-Handle.
Row1Row1Row1Row1row1 (input_control) rectangle.origin.y(-array) → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Zeilenindex der linken oberen Ecke.
Defaultwert: 10
Typischer Wertebereich: 0
≤
Row1
Row1
Row1
Row1
row1
≤
511 (lin)
Minimale Schrittweite: 1
Empfohlene Schrittweite: 1
Column1Column1Column1Column1column1 (input_control) rectangle.origin.x(-array) → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Spaltenindex der linken oberen Ecke.
Defaultwert: 10
Typischer Wertebereich: 0
≤
Column1
Column1
Column1
Column1
column1
≤
511 (lin)
Minimale Schrittweite: 1
Empfohlene Schrittweite: 1
Row2Row2Row2Row2row2 (input_control) rectangle.corner.y(-array) → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Zeilenindex der rechten unteren Ecke.
Defaultwert: 118
Typischer Wertebereich: 0
≤
Row2
Row2
Row2
Row2
row2
≤
511 (lin)
Minimale Schrittweite: 1
Empfohlene Schrittweite: 1
Restriktion: Row2 > Row1
Column2Column2Column2Column2column2 (input_control) rectangle.corner.x(-array) → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Spaltenindex der rechten unteren Ecke.
Defaultwert: 118
Typischer Wertebereich: 0
≤
Column2
Column2
Column2
Column2
column2
≤
511 (lin)
Minimale Schrittweite: 1
Empfohlene Schrittweite: 1
Restriktion: Column2 >= Column1
Beispiel (HDevelop)
* Erase a rectangle in the output window interactively:
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
Beispiel (C)
/* Erase a rectangle in the output window interactively: */
draw_rectangle1(WindowHandle,&L1,&C1,&L2,&C2);
Beispiel (HDevelop)
* Erase a rectangle in the output window interactively:
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
Beispiel (HDevelop)
* Erase a rectangle in the output window interactively:
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
Beispiel (HDevelop)
* Erase a rectangle in the output window interactively:
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
Ergebnis
Ist ein Ausgabefenster vorhanden und sind die angegebenen Parameter korrekt,
dann liefert clear_rectangleclear_rectangleClearRectangleClearRectangleClearRectangle den Wert 2 (H_MSG_TRUE).
Andernfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
open_windowopen_windowOpenWindowOpenWindowOpenWindow,
set_drawset_drawSetDrawSetDrawSetDraw,
set_colorset_colorSetColorSetColorSetColor,
set_coloredset_coloredSetColoredSetColoredSetColored,
set_line_widthset_line_widthSetLineWidthSetLineWidthSetLineWidth,
set_rgbset_rgbSetRgbSetRgbSetRgb,
set_hsiset_hsiSetHsiSetHsiSetHsi,
draw_rectangle1draw_rectangle1DrawRectangle1DrawRectangle1DrawRectangle1
Alternativen
clear_windowclear_windowClearWindowClearWindowClearWindow,
disp_rectangle1disp_rectangle1DispRectangle1DispRectangle1DispRectangle1
Siehe auch
open_windowopen_windowOpenWindowOpenWindowOpenWindow
Modul
Foundation