4D v14.3

FORM LOAD

Home

 
4D v14.3
FORM LOAD

FORM LOAD 


 

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

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.

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.   

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.

Ein Projektformular in einem Druckauftrag aufrufen:

 OPEN PRINTING JOB
 FORM LOAD("Druckformular")
  // Ereignisse und Objektmethoden ausführen

Ein Tabellenformular in einem Druckauftrag aufrufen:

 OPEN PRINTING JOB
 FORM LOAD([People];"Druckformular")
  // Ereignisse und Objektmethoden ausführen

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

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Formulare
Nummer: 1103

 
GESCHICHTE 

New
Erstellt: 4D v12
Geändert: 4D v14
Umbenannt: 4D v14

 
SIEHE AUCH 


Current form name
FORM UNLOAD
LISTBOX GET OBJECTS
OBJECT Get type
Print object

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)

Geerbt von : OPEN PRINTING FORM ( 4D v12.4)