Lade...
 

Fenster

Window

Window(name, flags, x, y, w, h[, [title][, bitmapFile]])

Parameter
Parameter   Beschreibung
name * Identifikator des Windows
flags   Flags
x * Position X (in Minicells)
y * Position Y (in Minicells)
w * Breite des Windows (in Minicells)
h * Höhe des Windows (in Minicells)
title   Titel als String oder (mehrsprachig) als Multiple-String-Konstante
bitmapFile   Filename einer Grafikdatei für den Hintergrund des Windows
  • - Pflichtparameter

    Der Ursprung 0, 0 der Koordinaten x und y liegt per Default in der linken

oberen Bildschirmecke. Durch Setzen der Umgebungsvariablen CX_RELATIVE_WINDOW_POS kann der Ursprung aber auf die linke obere Ecke des Control-Windows gesetzt werden. Dies dient dazu, neue Fenster vor dem Control-Window zu öffnen (auf demselben Bildschirm), auch wenn der Benutzer das Control-Window woanders hin verschoben hat.

 

 

Flags
Flag Beschreibung
LOAD Das Window wird bei Programmstart geöffnet. Windows ohne dieses Flag müssen explizit mit OpenWindow auf den Bildschirm gebracht werden. Wurde das LOAD-Flag bei keinem Window angegeben, so wird trotzdem das als erstes definierte Window geöffnet.
LAYOUT Ein einfaches Geometriemanagement wird beim Ändern der Fenstergröße angewendet. Aufgrund der angegebenen Koordinaten werden Größenänderungen proportional nachgeführt. Für anspruchsvolleres Layoutmanagement siehe Attach und Constraint.
STARTUP Das Window erscheint während der Startphase des Systems. Danach verschwindet es automatisch und Windows mit Flag LOAD werden geöffnet.
BACKGROUND_KEEP_RATIO
190484
Die Grafik des Hintergrundes wird um den Fenstermittelpunkt so skaliert, dass das Seitenverhältnis erhalten bleibt, aber das Fenster immer komplett gefüllt ist.
BITMAP_SIZE Wenn eine Grafik für den Hintergrund angegeben wurde, bestimmt diese die Größe des Windows (Parameter w und h werden ignoriert). Ohne Flag BITMAP_SIZE passt sich die Grafik der Größe des Fensters an und wird dementsprechend gestaucht bzw. gestreckt.
CONTROL_WINDOW

Das Window wird zum Hauptfenster. Das Flag ist dem Befehl ControlWindow der Übersicht halber wenn möglich vorzuziehen. Das Fenster verhält sich dann so, als ob beim Öffnen des Fensters der Befehl ControlWindow ausgeführt würde.

HIDDEN Das Window bleibt solange unsichtbar, bis die Anweisung Show es auf dem Bildschirm erscheinen lässt.
MODAL Wird ein Window mit Flag MODAL eröffnet, so sind die anderen, gleichzeitig auf dem Bildschirm sichtbaren Windows der Anwendung interaktiv nicht mehr zugänglich. Man benutzt dieses Flag, wenn das Window eine Aufforderung an den Anwender übermittelt und man ihn zwingen will, jetzt darauf zu reagieren.
FLOAT 190484 Ein mit FLOAT gekennzeichnetes Fenster bleibt stets im Vordergrund. Jedoch lassen sich die anderen Fenster im Gegensatz zu MODAL noch bedienen.
LOCKED Das Window kann interaktiv nicht geschlossen werden (das entsprechende Item im Systemmenü ist inaktiv).
TOOLTIP(mlString) Der angegebene String wird als Hinweistext (Tooltip) eingeblendet oder, falls ein Event TOOLTIP ebenfalls definiert ist, an diesen übergeben. Das Erscheinen des Tooltips wird vom System automatisch nach einer bestimmten Zeit des Verharrens des Maus-Cursors über dem Windowobjekt ausgelöst. Der String kann mehrsprachig sein. An den Event wird der jeweils zur eingestellten Sprache aktuelle übergeben.

Der Tooltip erscheint auf den Flächen des Windows, auf denen kein anderes (Child-) Windowobjekt dargestellt ist. Allgemein übernimmt immer das Windowobjekt die Kontrolle über gegebenenfalls erscheinende Tooltips, das zu oberst unter dem Maus-Cursor liegt.

CONTEXTMENU(identifikator) Der Identifikator ist ein Bezeichner eines Items innerhalb einer Menu- oder ContextMenuList-Deklaration. Das unter diesem Item hängende Untermenu wird automatisch beim Betätigen der rechten Maustaste eingeblendet. Wird daraufhin ein Menupunkt ausgewählt, wird wie zu Item beschrieben die jeweilige Aktion gestartet, in gleicher Weise, als wäre der Menueintrag aus dem Hauptmenu heraus aufgerufen worden.
Zusätzlich kann man jedoch bei Ausführung von SELECT zu dem entsprechenden Item mittels GetCurrentWidget ermitteln, aus welchem Windowobjekt heraus der Menupunkt via ContextMenu aufgerufen wurde. Bei einem Aufruf aus dem Hauptmenu liefert GetCurrentWidget NULL zurück.

Soll ein ContextMenu nicht automatisch erscheinen, so kann es (nach Gestaltungsrichtlinie sollte dies als Reaktion auf die rechte Maustaste, also innerhalb MOUSE_CLICK_R erfolgen) mittels PopupMenu auch aus InstantView® heraus aufgerufen werden. In diesem Fall sollte auf die Angabe des Flags CONTEXTMENU verzichtet werden, da sonst das Menu zweimal (einmal automatisch, einmal gesteuert) erscheint.

MIN_HEIGHT(h)

h = Höhenangabe in Minicells.

Überschreibt den Höhenwert des Fensters, wenn dieser geringer ist als der Wert h. Abgesehen davon lässt sich das Window mit diesem Flag unverändert beliebig resizen.

MIN_WIDTH(w)

w = Breitenangabe in Minicells.

Überschreibt den Breitewert des Fensters, wenn dieser geringer ist als der Wert w. Abgesehen davon lässt sich das Window mit diesem Flag unverändert beliebig resizen.

NO_MOVE Das Window kann interaktiv nicht verschoben werden.
NO_SIZE Das Window kann interaktiv nicht vergrößert/verkleinert werden.
SELECT_MULTIPLE Radio-Buttons oder Check-Boxes werden oft in einer Group zusammengefasst. Sie können aber auch direkte Childobjekte eines Windows sein. In diesem Fall muss für das Window SELECT_MULTIPLE angegeben werden.
ACCEPT_DROP Objekte einer Objektbox können mit Drag-and-Drop interaktiv zu einer anderen Objektbox oder zu einem Window gezogen werden. Das Objekt kann nur auf einem Window mit Flag ACCEPT_DROP abgelegt werden. In der Aktionsliste muss beschrieben werden, was mit dem Objekt geschehen soll (siehe Beispiel).

Hinweis: Aus einer Objektbox mit Flag SELECT_MULTIPLE kann man nur dann ein Objekt zu einem Window ziehen, wenn dort genau ein Objekt selektiert ist.

HELP(anchor) HELP("file#anchor") verbindet das Windowobjekt mit Online-Hilfe im HTML-Format. Wenn kein Filename angegeben wurde, gilt die im Modul festgelegte HTML-Datei.
HELP(n) Möchte man lieber das Help-System der Plattform benutzen (nur OS/2 PM), so ist eine ganze Zahl n anzugeben, die auf das entsprechende Hilfe-Fenster verweist. Dabei muss n < 40000 sein.
VT_SCROLL_BAR Das Fenster erhält einen vertikalen Scrollbar. WICHTIG! Der Scrollbar wird erst eingeblendet, wenn Widget außerhalb des sichtbaren Bereichs liegen.
HZ_SCROLL_BAR Das Fenster erhält einen horizontalen Scrollbar. WICHTIG! Der Scrollbar wird erst eingeblendet, wenn Widget außerhalb des sichtbaren Bereichs liegen.