WinDialogRun

obj -> WinDialogRun([int1[, handle2]]) : int

Geladenes Fenster anzeigen

Details

• obj: Fenster
• int1: Optionen (optional; siehe Text)
• handle2: Elternfenster (optional)
• Resultat: int Schaltflächen-ID
• Siehe: Verwandte Befehle , WinOpen () , WinOpen () , Beispiel

Mit diesem Befehl wird ein geladenes Fenster -Objekt angezeigt. Das Objekt muss zuvor mit dem Befehl WinOpen () geladen worden sein. Als (obj) wird der zurückgegebene Deskriptor oder der Name des Fenster-Objektes mit einem vorangestellten $ (zum Beispiel $Meldung) verwendet.

Folgende Optionen (int1) können angegeben werden:

• _WinDialogAlwaysOnTop Das Fenster (obj) wird immer im Vordergrund angezeigt.
• _WinDialogApp Der CONZEPT 16-Client wird versteckt.
• _WinDialogAsync Das Fenster (obj) wird asynchron zur laufenden Prozedur angezeigt.
• _WinDialogCenter Das Fenster (obj) wird zum Elternfenster (handle2) zentriert.
• _WinDialogCenterX Das Fenster (obj) wird zum Elternfenster (handle2) horizontal zentriert.
• _WinDialogCenterY Das Fenster (obj) wird zum Elternfenster (handle2) vertikal zentriert.
• _WinDialogCenterScreen Das Fenster (obj) wird zum Bildschirm zentriert.
• _WinDialogCenterScreenX Das Fenster (obj) wird zum Bildschirm horizontal zentriert.
• _WinDialogCenterScreenY Das Fenster (obj) wird zum Bildschirm vertikal zentriert.
• _WinDialogCreateHidden Obsolet. Sollte nicht mehr verwendet werden.
• _WinDialogMaximized Das Fenster (obj) wird maximiert dargestellt.
• _WinDialogMinimized Das Fenster (obj) wird minimiert dargestellt.
• _WinDialogNormal Das Fenster (obj) wird weder minimiert noch maximiert dargestellt.
• _WinDialogNoActivate Das Fenster (obj) wird inaktiv gestartet.

Die Optionen _WinDialogAlwaysOnTop, _WinDialogApp, _WinDialogAsync und _WinDialogNoActivate können mit einer der anderen Optionen kombiniert werden.

Wird (handle2) nicht angegeben, ist der CONZEPT 16-Client das Eltern-Objekt des Dialoges. Andernfalls ist das Objekt, dessen Objektdeskriptor in (handle2) angegeben ist, das Elternfenster. Als Elternfenster kann nur ein Fenster / MDI-Fenster -Objekt angegeben werden.

Der Wert der Eigenschaft ID der gedrückten Schaltfläche im Fenster wird als Resultat zurückgegeben.

Über die Funktion WinDialogResult () kann der Rückgabewert von WinDialogRun() individuell gesetzt werden.

Nach dem Schließen (entweder durch das Drücken einer Schließen-Schaltfläche oder durch die Ausführung der Anweisung WinClose ()) befindet sich das Fenster noch im Speicher. Es kann also auch nach der Anweisung WinDialogRun() auf die Eigenschaften und Objekte des Dialoges zugegriffen werden. Der Dialog wird erst nach einem erneuten Aufruf von WinClose () aus dem Speicher entfernt und kann auch erst dann wieder geladen und angezeigt werden.

Beispiel:

// Fenster laden
WinOpen('Message');
// Fenster zentriert anzeigen
tRes # $Message->WinDialogRun(_WinDialogCenterScreen);
// Fenster entladen
$Message->WinClose();
switch (tRes)
{
  // OK-Schaltfläche gedrückt
  case _WinIdClose :
  {
    ...
  }
  ...
}

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: Fenster (obj) ungültig