Zum Hauptinhalt springen

WinSave

obj -> WinSave(int1[, alpha2]) : 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

Fenster-Objekt speichern

Details

  • obj: Deskriptor des Fenster-Objekts
  • int1:
    • Optionen:
    • _WinSaveDefault
    • _WinSaveOverwrite
    • _WinSaveRsc
    • _WinSaveXml
  • alpha2: Name des Fenster-Objekts (optional)
  • Resultat: int Fehlerwert
  • Siehe: WinOpen () , WinCreate ()

Mit dieser Anweisung kann ein mit WinOpen () geöffnetes oder mit WinCreate () erstelltes Fenster-Objekt in der Datenbank oder extern gespeichert werden. Wurde das Objekt mit WinOpen () geöffnet, muss dies mit der Option _WinOpenLock gesperrt worden sein.

Als (obj) wird der Deskriptor des Fenster-Objekts übergeben, der von WinOpen () bzw. WinCreate () zurückgegeben wurde. Als Optionen stehen folgende Konstanten zur Verfügung:

  • _WinSaveDefault ( 0 ) - bestehendes Objekt nicht überschreiben Das Objekt wird unter dem in (alpha2) übergebenem Namen gespeichert. Existiert das Objekt bereits, wird der Fehler _ErrExists zurückgegeben.
  • _WinSaveOverwrite ( 1 ) - bestehendes Objekt überschreiben Das Objekt wird unter dem in (alpha2) angegebenem Namen gespeichert, auch dann, wenn ein gleichnamiges Objekt bereits existiert. Das entsprechende Objekt wird überschrieben.
  • _WinSaveRsc ( 0x20000 ) - Objekt als RSC-Datei speichern Das Objekt wird unter dem in (alpha2) angegebenen Pfad und Dateinamen gespeichert.
  • _WinSaveXml ( 0x10000 ) - Objekt als XML-Datei speichern Das Objekt wird unter dem in (alpha2) angegebenen Pfad und Dateinamen gespeichert.

Wird kein Name angegeben, wird der Name des Objekts (Eigenschaft Name) verwendet. Es wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Der Rückgabewert der Anweisung kann mit folgenden Konstanten verglichen werden:

  • _ErrOk: Das Objekt wurde gespeichert (kein Fehler).
  • _ErrNameInvalid: Der Name für das Objekt ist ungültig (Argument (alpha2)).
  • _ErrLocked: Das Objekt wird vom aktuellen Client im Designer editiert oder ist bereits durch _WinOpenLock geöffnet.
  • _ErrExists: Ein Objekt unter diesem Namen existiert bereits in der Datenbank und _WinSaveOverwrite ist nicht angegeben.
  • _ErrRights: Benutzerrechte nicht ausreichend.
  • _rDeadlock: Verklemmung aufgetreten

Beispiel:

tHdlFrm # WinOpen('Avi', _WinOpenDialog | _WinOpenLock | _WinOpenEventsOff);
tHdlFrm->wpCaption # 'Animation';
tErg # tHdlFrm->WinSave(_WinSaveDefault);

Mögliche Laufzeitfehler:

  • _ErrHdlInvalid: Der in (obj) übergebene Deskriptor ist ungültig, ist kein Fenster-Objekt oder nicht gesperrt.
  • _ErrValueInvalid: In (int1) ist ein ungültiger Wert übergeben worden. Der Fehler wird auch zurückgegeben, wenn _WinSaveRsc und _WinSaveXml angegeben werden.
  • _ErrStringOverflow: In (alpha2) wurde ein Name mit mehr als 40 Zeichen übergeben.