4D Doc Center : FORM LOAD

Home

4D v14.3

FORM LOAD


FORM LOAD ( {Tabellenname ;} Formularname {; *} )

Parameter	Typ	Beschreibung
Tabellenname	Tabelle	Zu ladendes Tabellenformular (wenn weggelassen, wird Projektformular geladen)
Formularname	String	Name des zu öffnenden Formulars (Projekt oder Tabelle)
*	Operator	Mit * wird der Befehl auf Host Datenbank angewandt, wenn er von einer Komponente ausgeführt wird (außerhalb dieses Kontexts wird der Parameter ignoriert)

Beschreibung

Der Befehl FORM LOAD lädt das Formular Formularname (Projekt oder Tabelle) im Speicher in den aktuellen Prozess, um seine Daten zu drucken oder den Inhalt zu analysieren . Es gibt immer nur ein aktuelles Formular pro Prozess.

Daten mit diesem Formular drucken

Um diesen Befehl auszuführen, muss zuvor mit dem Befehl OPEN PRINTING JOB ein Druckauftrag geöffnet werden. Das geladene Formular wird zum aktuellen Druckformular. Alle Befehle zur Objektverwaltung sowie die Funktion Print object arbeiten mit diesem Formular.

Wurde bereits zuvor ein Druckformular geladen (über einen früheren Aufruf von FORM LOAD), wird es geschlossen und durch Formularname ersetzt. Sie können in der gleichen Drucksitzung verschiedene Projektformulare öffnen und schließen. Beim Ändern des Druckformulars über FORM LOAD werden keine Umbrüche generiert. Der Entwickler muss selbst die Seitenumbrüche verwalten. Übergeben Sie einen leeren String in Formularname, wird das aktuelle Projektformular zum Drucken geschlossen.
Nur das Formularereignis On Load wird beim Öffnen des Projektformulars ausgeführt. Die anderen Formularereignisse werden ignoriert. Das Formularereignis On Unload wird am Ende des Druckens ausgeführt.

Um die grafische Konsistenz von Formularen beizubehalten, empfehlen wir, die Darstellungseigenschaft "Drucken" unabhängig von der Plattform anzuwenden.

Das aktuelle Druckformular wird automatisch geschlossen, wenn der Befehl CLOSE PRINTING JOB aufgerufen wird.

Hinweis zur Kompatibilität: Früher hieß dieser Befehl OPEN PRINTING FORM und akzeptierte im Parameter Formularname auch einen leeren String, um das aktuelle Projektformular zu schließen. Diese Syntax wird nicht mehr unterstützt, sie gibt einen Fehler zurück. Verwenden Sie jetzt zum Schließen des Formulars die Befehle FORM UNLOAD oder CLOSE PRINTING JOB.

Inhalt des Formulars analysieren (parsen)

Hier wird ein off-screen Formular zur Analyse des Inhalts geladen. Dazu rufen Sie FORM LOAD außerhalb eines Druckauftrags auf. In diesem Anwendungsfall werdendie Formularereignisse nicht ausgeführt.

FORM LOAD lässt sich zusammen mit den Befehlen FORM GET OBJECTS und OBJECT Get type verwenden, um den Inhalt des Formulars abzufragen. Sie müssen zum Schluss den Befehl FORM UNLOAD aufrufen, um das Formular aus dem Speicher zu entfernen.

Beachten Sie, dass ein bereits angezeigtes Formular auf dem Bildschirm dabei geladen bleibt (es ist vom Befehl FORM LOAD nicht betroffen), es muss also nach Aufruf von FORM UNLOAD nicht erneut geladen werden.

Wird der Befehl über eine Komponente ausgeführt, lädt er standardmäßig die Formulare der Komponente. Mit dem Parameter * lädt die Methode die Formulare der Host Datenbank.

Beispiel 1

Ein Projektformular in einem Druckauftrag aufrufen:

 OPEN PRINTING JOB

 FORM LOAD("Druckformular")

  // Ereignisse und Objektmethoden ausführen

Beispiel 2

Ein Tabellenformular in einem Druckauftrag aufrufen:

 OPEN PRINTING JOB

 FORM LOAD([People];"Druckformular")

  // Ereignisse und Objektmethoden ausführen

Beispiel 3

Inhalt des Formulars analysieren (parsen), um Eingabebereiche für Text zu bearbeiten:

 FORM LOAD([People];"my_form")

  // Formular ohne Ausführen von Ereignissen oder Methoden auswählen

 FORM GET OBJECTS(arrObjNames;arrObjPtrs;arrPages;*)

 For($i;1;Size of array(arrObjNames))

    If(OBJECT Get type(*;arrObjNames{$i})=Object type text input)

  //… Bearbeitungen

    End if

 End for

 FORM UNLOAD