dev_set_window_extentsdev_set_window_extentsDevSetWindowExtentsDevSetWindowExtentsdev_set_window_extents (Operator)

Name

dev_set_window_extentsdev_set_window_extentsDevSetWindowExtentsDevSetWindowExtentsdev_set_window_extents — Position und Größe des aktiven Grafikfensters verändern.

Signatur

dev_set_window_extents( : : Row, Column, Width, Height : )

Beschreibung

dev_set_window_extentsdev_set_window_extentsDevSetWindowExtentsDevSetWindowExtentsDevSetWindowExtentsdev_set_window_extents setzt für das aktive schwebende Grafikfenster die Position und/oder die Größe neu.

Die Parameter RowRowRowRowrowrow und ColumnColumnColumnColumncolumncolumn bestimmen die neue Position des Fensters (linke obere Ecke). Beachten Sie, dass die unter Bearbeiten -> Einstellungen -> Allgemeine Optionen -> Allgemeine Optionen -> Window open offset angegebenen Versatzwerte zum Zeileindex bzw. zum Spaltenindex addiert werden. Weitere Informationen finden Sie im Kapitel „Menu Edit“ im „HDevelop User's Guide“. Negative Koordinaten werden ignoriert, d.h. das Fenster wird nicht in Richtung der negativen Koordinate(n) verschoben.

Die Parameter WidthWidthWidthWidthwidthwidth und HeightHeightHeightHeightheightheight bestimmen die neue Größe des Fensters, und zwar die Größe des inneren Teils des Grafikfensters -- der eigentlichen Ausgabefläche für die ikonischen Objekte. Negative Werte für die Größe werden ebenfalls ignoriert, d.h. in dieser Richtung ändert sich die Größe nicht.

Achtung

Dieser Operator funktioniert nur für einzelne schwebende Grafikfenster, d.h. Grafikfenster, die weder angedockt noch mit Registerkarten versehen sind.

Ein HDevelop Grafikfenster darf nicht mit set_window_extentsset_window_extentsSetWindowExtentsSetWindowExtentsSetWindowExtentsset_window_extents verschoben oder verändert werden. Dies darf nur mit dem Operator dev_set_window_extentsdev_set_window_extentsDevSetWindowExtentsDevSetWindowExtentsDevSetWindowExtentsdev_set_window_extents geschehen.

Beim Export von HDevelop-Programmen ist zu beachten, dass der für diesen Operator generierte Code sich anders verhalten kann, als der entsprechende HALCON-Operator. Eine detaillierte Beschreibung der Besonderheiten, die beim Export von grafischen HDevelop-Operatoren zu beachten sind, findet sich im „HDevelop User's Guide“ im Kapitel Code Export -> General Aspects of Code Generation -> Graphics Windows.

Parameter

RowRowRowRowrowrow (input_control) rectangle.origin.y → (integer)

Zeilenindex der linken oberen Ecke.

Defaultwert: 0

Typischer Wertebereich: 0 ≤ Row Row Row Row row row

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Restriktion: Row >= 0 || Row == -1

ColumnColumnColumnColumncolumncolumn (input_control) rectangle.origin.x → (integer)

Spaltenindex der linken oberen Ecke.

Defaultwert: 0

Typischer Wertebereich: 0 ≤ Column Column Column Column column column

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Restriktion: Column >= 0 || Column == -1

WidthWidthWidthWidthwidthwidth (input_control) rectangle.extent.x → (integer)

Breite des Fensters.

Defaultwert: 256

Typischer Wertebereich: 0 ≤ Width Width Width Width width width

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Restriktion: Width > 0 || Width == -1

HeightHeightHeightHeightheightheight (input_control) rectangle.extent.y → (integer)

Höhe des Fensters.

Defaultwert: 256

Typischer Wertebereich: 0 ≤ Height Height Height Height height height

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Restriktion: Height > 0 || Height == -1

Beispiel (HDevelop)

dev_close_window ()
read_image (For5, 'for5')
get_image_size (For5, Width, Height)
dev_open_window (0, 0, Width, Height, 'black', WindowHandle)
dev_display (For5)
stop ()
dev_set_window_extents (-1,-1,Width/2,Height/2)
dev_display (For5)
stop ()
dev_set_window_extents (200,200,-1,-1)

Ergebnis

Sind die Parameterwerte korrekt, dann liefert dev_set_window_extentsdev_set_window_extentsDevSetWindowExtentsDevSetWindowExtentsDevSetWindowExtentsdev_set_window_extents den Wert TRUE. Andernfalls wird eine Fehlerbehandlung durchgeführt und ein Fehlercode zurückgeliefert.

Nachfolger

dev_displaydev_displayDevDisplayDevDisplayDevDisplaydev_display, dev_set_lutdev_set_lutDevSetLutDevSetLutDevSetLutdev_set_lut, dev_set_colordev_set_colorDevSetColorDevSetColorDevSetColordev_set_color, dev_set_drawdev_set_drawDevSetDrawDevSetDrawDevSetDrawdev_set_draw, dev_set_partdev_set_partDevSetPartDevSetPartDevSetPartdev_set_part

Siehe auch

set_window_extentsset_window_extentsSetWindowExtentsSetWindowExtentsSetWindowExtentsset_window_extents

Modul

Foundation