4D Doc Center : FORM SCREENSHOT

Home

4D v14.3

FORM SCREENSHOT


FORM SCREENSHOT ( {{TabellenName ;} FormularName ;} FormularBild {; SeitenNr} )

Parameter	Typ	Beschreibung
TabellenName	Tabelle	Tabelle zum Formular
FormularName	Text	Name des Formulars
FormularBild	Bild	Ohne die beiden ersten Parameter: Bild des gerade ausgeführten Formulars Mit Formularname: Bild des Formulars im Formulareditor
SeitenNr	Lange Ganzzahl	Seitennummer des Formulars

Beschreibung

Der Befehl FORM SCREENSHOT gibt ein Formular als Bild zurück. Dieser Befehl erlaubt zwei Syntaxarten: Je nach der verwendeten Syntax erhalten Sie entweder ein Bild des ausgeführten Formulars oder ein Bild des Formulars im Formulareditor.

FORM SCREENSHOT (FormularBild)
Diese Syntax erhält das exakte Abbild der aktuellen Seite des Formulars,das gerade ausgeführt oder über den Befehl FORM LOAD geladen wird: Das Bild, das im Parameter FormularBild zurückgegeben wird, enthält alle sichtbaren Objekte des Formulars mit den aktuellen Werten von Feld und Variable des Formulars, Unterformulars, etc. Das Formular wird komplett zurückgegeben, ohne Berücksichtigung der Größe des Fensters, in dem das Formular enthalten ist.
Beachten Sie, dass diese Syntax nur mit Eingabeformularen funktioniert.

FORM SCREENSHOT ( {TabellenName ;} FormularName ; FormularBild {; SeitenNr} )
Diese Syntax erhält ein Abbild einer sog. Formularvorlage, wie sie im Formulareditor angezeigt wird. Alle sichtbaren Objekte werden so gezeichnet, wie sie im Editor vorkommen; diese Syntax berücksichtigt auch vererbte Formulare und Objekte, die auf Seite 0 liegen.
Wollen Sie ein Abbild für ein Tabellenformular, übergeben Sie im Parameter TabellenName die Formulartabelle und dann ihren Namen als String in FormularName. Für ein Projektformular übergeben Sie den Formularnamen direkt in FormularName.
Der Befehl gibt standardmäßig ein Abbild von Seite 1 des Formulars zurück. Wollen Sie nur ein Bild von Seite 0 oder von einer anderen Seite des Formulars, übergeben Sie die gewünschte Seitennummer im Parameter SeitenNr.

Hinweis: Da die beiden ersten Parameter dieses Befehls optional sind, können Sie eine Funktion, die einen Zeiger zurückgibt, wie z.B. Current form table-> oder Table->, nicht direkt als Argument übergeben. Diese Syntax funktioniert im interpretierten Modus, wird aber beim Kompilieren abgewiesen. Hier müssen Sie stattdessen eine dazwischengesetzte Zeiger-Variable verwenden. Weitere Information dazu finden Sie im Abschnitt Befehle mit Zeigern direkt verwenden.