dev_set_window_extentsdev_set_window_extentsDevSetWindowExtentsdev_set_window_extentsDevSetWindowExtentsDevSetWindowExtents (Operator)

Name

dev_set_window_extentsdev_set_window_extentsDevSetWindowExtentsdev_set_window_extentsDevSetWindowExtentsDevSetWindowExtents — 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_extentsDevSetWindowExtentsdev_set_window_extentsDevSetWindowExtentsDevSetWindowExtents setzt für das aktive Grafikfenster die Position und/oder die Größe neu.

Die Parameter RowRowRowRowRowrow und ColumnColumnColumnColumnColumncolumn bestimmen die neue Position des Fensters (linke obere Ecke). Abhängig vom eingestellten Fenstermodus in HDevelop beziehen sich die Koordinaten (0,0) auf die linke obere Ecke im Fensterbereich des Hauptfensters im MDI-Modus bzw. die linke obere Ecke des Bildschirms im SDI-Modus. 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

Ein HDevelop Grafikfenster darf nicht mit set_window_extentsset_window_extentsSetWindowExtentsset_window_extentsSetWindowExtentsSetWindowExtents verschoben oder verändert werden. Dies darf nur mit dem Operator dev_set_window_extentsdev_set_window_extentsDevSetWindowExtentsdev_set_window_extentsDevSetWindowExtentsDevSetWindowExtents 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_extentsDevSetWindowExtentsdev_set_window_extentsDevSetWindowExtentsDevSetWindowExtents den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt und ein Fehlercode zurückgeliefert.

Nachfolger

dev_displaydev_displayDevDisplaydev_displayDevDisplayDevDisplay, dev_set_lutdev_set_lutDevSetLutdev_set_lutDevSetLutDevSetLut, dev_set_colordev_set_colorDevSetColordev_set_colorDevSetColorDevSetColor, dev_set_drawdev_set_drawDevSetDrawdev_set_drawDevSetDrawDevSetDraw, dev_set_partdev_set_partDevSetPartdev_set_partDevSetPartDevSetPart

Siehe auch

set_window_extentsset_window_extentsSetWindowExtentsset_window_extentsSetWindowExtentsSetWindowExtents

Modul

Foundation