LayoutControl

Ein LayoutControl-Objekt stellt eine „Dekoration“ in einem Eingabeformular dar, die mit keinem Feld von Datensätzen in Verbindung steht. Es gibt drei Feld-Typen:

  • HTMLLayoutControl für zusätzliches HTML das im Eingabeformular angezeigt wird (Formatierter Text im FormBuilder);

  • ImageLayoutControl für ein Dekobild;

  • ButtonLayoutControl für einen „Absenden“-Button;

Ein LayoutControl-Objekt kann sowohl einer App zugeordnet sein (wenn es einen aktiven View gibt) als auch direkt einem View.

Allgemeine Attribute

Allen Objekte-Typen gemeinsam sind folgende Attribute:

idString

Der eindeutige Datenbank-Identifizierer des LayoutControls.

viewView

Das View-Objekt zu diesem LayoutControl.

labelString

Die Beschriftung.

identifierString

Der menschenlesbare Identifizierer des Feldes (dies ist eine Version der Beschriftung, die in einen gültigen UL4-Variablennamen ungewandelt wurde und eindeutig ist).

typeString

Der Typ des Layoutfelder: "string", "image" oder "button".

subtypeString oder None

Der Untertyp des Layoutfelder: "html" beim Typ "string" und None beim Typ "image" und "button".

topInteger

Vertikale Position des Feldes im Eingabeformular in dieser bzw. der aktiven Formularvariante.

leftInteger

Horizontale Position des Feldes im Eingabeformular in dieser bzw. der aktiven Formularvariante.

widthInteger

Breite des Feldes im Eingabeformular in dieser bzw. der aktiven Formularvariante.

heightInteger

Höhe des Feldes im Eingabeformular in dieser bzw. der aktiven Formularvariante.

z_indexInteger

Überlagerungs-Reihenfolge des Feldes in dieser bzw. der aktiven Formularvariante.

visibleBool

Soll dieses Layoutfeld in dieser bzw. der aktiven Formularvariante angezeigt werden?

x_<identifier>Objekt

Es werden beliebige zusätzliche Attribute unterstützt deren Namen mit x_ beginnt.

Attribute für HTMLLayoutControl-Felder

HTMLLayoutControl-Felder haben zusätzlich das folgende Attribut:

valuestring

Der HTML-Quelltext.

Attribute für ImageLayoutControl-Felder

ImageLayoutControl-Felder haben zusätzlich das folgenden Attribut:

imageFile

Das Original-Bild, das vom Benutzer hochgeladen wurde.

Zur Anzeige sollte es mittels scaled_url(…) auf die durch die Attribute width und height festgelegte Größe skaliert werden.