HALCON Website / HALCON Operator-Referenz / Graphik / Fenster
KlassenKlassenKlassenKlassen | | | | Operatoren

clear_rectangleclear_rectangleClearRectangleclear_rectangleClearRectangleClearRectangle (Operator)

Name

clear_rectangleclear_rectangleClearRectangleclear_rectangleClearRectangleClearRectangle — Löschen eines Rechtecks auf dem Ausgabefenster.

Signatur

clear_rectangle( : : WindowHandle, Row1, Column1, Row2, Column2 : )

Herror clear_rectangle(const Hlong WindowHandle, const Hlong Row1, const Hlong Column1, const Hlong Row2, const Hlong Column2)

Herror T_clear_rectangle(const Htuple WindowHandle, const Htuple Row1, const Htuple Column1, const Htuple Row2, const Htuple Column2)

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

void HOperatorSetX.ClearRectangle(
[in] VARIANT WindowHandle, [in] VARIANT Row1, [in] VARIANT Column1, [in] VARIANT Row2, [in] VARIANT Column2)

void HWindowX.ClearRectangle(
[in] VARIANT Row1, [in] VARIANT Column1, [in] VARIANT Row2, [in] VARIANT Column2)

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_rectangleClearRectangleclear_rectangleClearRectangleClearRectangle löscht alle Einträge in dem Rechteck, das durch die linke obere Ecke (Row1Row1Row1Row1Row1row1,Column1Column1Column1Column1Column1column1) und die rechte untere Ecke (Row2Row2Row2Row2Row2row2,Column2Column2Column2Column2Column2column2) aufgespannt wird. Löschen bedeutet, dass das angegebene Rechteck auf die Hintergrundfarbe gesetzt wird (siehe open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow, open_textwindowopen_textwindowOpenTextwindowopen_textwindowOpenTextwindowOpenTextwindow).

Falls mehr als ein Rechteck gelöscht werden soll, können auch mehrere Rechtecke übergeben werden, d.h. die Parameter Row1Row1Row1Row1Row1row1, Column1Column1Column1Column1Column1column1, Row2Row2Row2Row2Row2row2 und Column2Column2Column2Column2Column2column2 sind jeweils Tupel.

Parallelisierung

Parameter

WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window → HWindow, HTupleHTupleHTupleHWindowX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Fenster-Handle.

Row1Row1Row1Row1Row1row1 (input_control)  rectangle.origin.y(-array) → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Zeilenindex der linken oberen Ecke.

Defaultwert: 10

Typischer Wertebereich: 0 ≤ Row1 Row1 Row1 Row1 Row1 row1 ≤ 511 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Column1Column1Column1Column1Column1column1 (input_control)  rectangle.origin.x(-array) → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Spaltenindex der linken oberen Ecke.

Defaultwert: 10

Typischer Wertebereich: 0 ≤ Column1 Column1 Column1 Column1 Column1 column1 ≤ 511 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Row2Row2Row2Row2Row2row2 (input_control)  rectangle.corner.y(-array) → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Zeilenindex der rechten unteren Ecke.

Defaultwert: 118

Typischer Wertebereich: 0 ≤ Row2 Row2 Row2 Row2 Row2 row2 ≤ 511 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Restriktion: Row2 > Row1

Column2Column2Column2Column2Column2column2 (input_control)  rectangle.corner.x(-array) → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Spaltenindex der rechten unteren Ecke.

Defaultwert: 118

Typischer Wertebereich: 0 ≤ Column2 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)
clear_rectangle(WindowHandle,L1,C1,L2,C2)

Beispiel (C)

/* Erase a rectangle in the output window interactively: */
draw_rectangle1(WindowHandle,&L1,&C1,&L2,&C2) ;
clear_rectangle(WindowHandle,L1,C1,L2,C2) ;

Beispiel (HDevelop)

* Erase a rectangle in the output window interactively:
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
clear_rectangle(WindowHandle,L1,C1,L2,C2)

Beispiel (HDevelop)

* Erase a rectangle in the output window interactively:
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
clear_rectangle(WindowHandle,L1,C1,L2,C2)

Beispiel (HDevelop)

* Erase a rectangle in the output window interactively:
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
clear_rectangle(WindowHandle,L1,C1,L2,C2)

Beispiel (HDevelop)

* Erase a rectangle in the output window interactively:
draw_rectangle1(WindowHandle,L1,C1,L2,C2)
clear_rectangle(WindowHandle,L1,C1,L2,C2)

Ergebnis

Ist ein Ausgabefenster vorhanden und sind die angegebenen Parameter korrekt, dann liefert clear_rectangleclear_rectangleClearRectangleclear_rectangleClearRectangleClearRectangle den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow, set_drawset_drawSetDrawset_drawSetDrawSetDraw, set_colorset_colorSetColorset_colorSetColorSetColor, set_coloredset_coloredSetColoredset_coloredSetColoredSetColored, set_line_widthset_line_widthSetLineWidthset_line_widthSetLineWidthSetLineWidth, set_rgbset_rgbSetRgbset_rgbSetRgbSetRgb, set_hsiset_hsiSetHsiset_hsiSetHsiSetHsi, draw_rectangle1draw_rectangle1DrawRectangle1draw_rectangle1DrawRectangle1DrawRectangle1

Alternativen

clear_windowclear_windowClearWindowclear_windowClearWindowClearWindow, disp_rectangle1disp_rectangle1DispRectangle1disp_rectangle1DispRectangle1DispRectangle1

Siehe auch

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow, open_textwindowopen_textwindowOpenTextwindowopen_textwindowOpenTextwindowOpenTextwindow

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 12.0.2 Copyright © 1996-2016 MVTec Software GmbH