Zum Hauptinhalt springen

WinLayer

WinLayer(int1[, handle2[, int3[, alpha4[, int5]]]]) : int​

Ausführbar von Clients mit grafischer Oberfläche Ausführbar vom Server Ausführbar von der DLL-Schnittstelle mit grafischer Erweiterung Ausführbar von der Web-Schnittstelle Ausführbar vom Druckprozessor Ausführbar von der ODBC-Schnittstelle Ausführbar vom SOA-Service mit grafischer Erweiterung

Layer-Modus für Frame-Objekte

Details

  • int1: Layer-Modus
  • handle2: Frame-Deskriptor
  • int3: Anzeigedauer
  • alpha4: Hinweistext
  • int5: Layer-Optionen
  • Resultat: int Resultat der Durchführung _ErrOK Der Befehl wurde erfolgreich durchgeführt _ErrInUse Der Befehl wurde wiederholt mit _WinLayerStart aufgerufen _ErrUnavailable Der Befehl kann nicht durchgeführt werden (siehe Text) Anweisung setzt den globalen Fehlerwert
  • Siehe: Verwandte Befehle

Der Befehl "friert" die Ausgabe eines vorgegebenen Frame-Objektes für eine bestimmte Zeitspanne ein. Änderungen an untergeordneten graphischen Objekten, während dieser Zeitspanne werden zwar durchgeführt, jedoch erst sichtbar nachdem die Zeitspanne abgelaufen ist, bzw. Layer-Modus abgeschaltet wird.

Für den Layer-Modus (int1) kann eine der folgenden Konstanten angegeben werden:

  • _WinLayerStart Diese Option startet den Layer-Modus für das Frame-Objekt (handle2). Es kann sich zu einem bestimmten Zeitpunkt jeweils nur ein Frame im Layer-Modus befinden. Das Argument (int3) definiert die Zeitspanne in Millisekunden, bis zur Beendigung des Layer-Modus. Wird das Argument nicht übergeben oder ist es 0, wird eine Zeitspanne von einer Sekunde angenommen. Im Argument (alpha4) kann eine Meldung übergeben werden, die in der Mitte des Anwendungsfensters ausgegeben wird. So kann der Benutzer über den Vorgang informiert werden.
  • _WinLayerEnd Diese Option beendet den Layer-Modus vor Ablauf der Zeitspanne. Es darf kein Frame-Deskriptor (handle2) angegeben werden. Alle anderen Argumente werden ignoriert.
  • _WinLayerUpdate Wird das Frame-Objekt während des Layer-Modus in Position oder Größe verändert, kann der Layer durch Aufruf mit dieser Option an das neue Fensterrechteck angepasst werden. Es darf kein Frame-Deskriptor (handle2) angegeben werden. Die übrigen Argumente können angegeben werden, um eine Änderung der Zeitspanne (int3) oder der Meldung (alpha4) durchzuführen. Das Argument (int5) wird ignoriert.

Im Argument (int5) können beim Modus (int1) _WinLayerStart folgende Optionen angegeben werden:

Diese Optionen können kombiniert werden.

War die Durchführung erfolgreich, liefert der Befehl _ErrOk. Im Fehlerfall ist das Resultat ein negativer Wert. Wird der Fehlerwert /docs/Components/CONZEPT_16-Client/Befehle_und_Funktionen/Befehle_und_Konstanten_fuer_Fehlermeldungen/Konstanten_fuer_Verarbeitungsfehler/ErrUnavailable#_ErrUnavailable zurückgegeben, liegt einer der folgenden Fälle vor:

  • Es gibt keine Fensterrepräsentation des Frame auf dem Bildschirm. Dies ist z. B. im Ereignis EvtInit der Fall. Die Fensterrepräsentation wird durch WinCreate() bzw. WinDialogRun() erzeugt.
  • Der Befehl wurde mit _WinLayerStart / _WinLayerEnd aufgerufen, es existiert jedoch kein Layer, entweder weil zuvor nicht _WinLayerStart durchgeführt wurde oder weil der Layer bereits beendet wurde.

Beispiele:

// Während des Theme-Wechsels, Hinweis für 1 Sekunde aktivieren
WinLayer(_WinLayerStart, $Frame, 1000, 'Theme wird erstellt', _WinLayerDarken);

...

// Layer-Modus vor Ablauf der Zeitspanne beenden
WinLayer(_WinLayerEnd);

Mögliche Laufzeitfehler: