dev_set_window_extentsdev_set_window_extentsDevSetWindowExtentsDevSetWindowExtents (Operator)

Name

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

Die Parameter RowRowRowRowrow und ColumnColumnColumnColumncolumn 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 WidthWidthWidthWidthwidth und HeightHeightHeightHeightheight 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_extentsSetWindowExtentsSetWindowExtentsSetWindowExtents verschoben oder verändert werden. Dies darf nur mit dem Operator dev_set_window_extentsdev_set_window_extentsDevSetWindowExtentsDevSetWindowExtentsDevSetWindowExtents 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

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

Zeilenindex der linken oberen Ecke.

Defaultwert: 0

Typischer Wertebereich: 0 ≤ Row Row Row Row row

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

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

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

Spaltenindex der linken oberen Ecke.

Defaultwert: 0

Typischer Wertebereich: 0 ≤ Column Column Column Column column

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

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

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

Breite des Fensters.

Defaultwert: 256

Typischer Wertebereich: 0 ≤ Width Width Width Width width

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

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

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

Höhe des Fensters.

Defaultwert: 256

Typischer Wertebereich: 0 ≤ 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_extentsDevSetWindowExtentsDevSetWindowExtentsDevSetWindowExtents den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt und ein Fehlercode zurückgeliefert.

Nachfolger

dev_displaydev_displayDevDisplayDevDisplayDevDisplay, dev_set_lutdev_set_lutDevSetLutDevSetLutDevSetLut, dev_set_colordev_set_colorDevSetColorDevSetColorDevSetColor, dev_set_drawdev_set_drawDevSetDrawDevSetDrawDevSetDraw, dev_set_partdev_set_partDevSetPartDevSetPartDevSetPart

Siehe auch

set_window_extentsset_window_extentsSetWindowExtentsSetWindowExtentsSetWindowExtents

Modul

Foundation