Diese Funktionalität ist nur in bestimmten Ausbaustufen verfügbar.

input

Das Element <input> fügt ein einfaches Eingabefeld, eine dropDown-Liste, ein Optionsfeld, ein Kontrollkästchen oder eine Schaltfläche mit Toggle-Funktion ein, das zur Eingabe oder Auswahl dient.

Bei der verdeckten Passworteingabe (type="password") wird statt eines eingegebenen Zeichens ein Stern (*) dargestellt.

Der Text kann auch als Link erstellt werden. Solche Links sind nicht, wie üblich, in blauer unterstrichener Schrift ausgeführt und der Link ist nur erreichbar, wenn die Taste [Alt] gedrückt wird.

Der Inhalt des Felds kann mit Hilfe der Formelsprache berechnet werden. Eingaben von Integer- oder Double-Werten werden eingeschränkt um Fehleingaben einzuschränken. Andere Zeichen außer den Folgenden können nicht eingegeben werden:

Attributname Verwendung Attributwerte Defaultwert Beschreibung
autoselect optional, nur für type = combo true, false false Steht für das dropDown-Listenfeld nur ein Wert zur Verfügung, kann dieser automatisch gesetzt werden.
Bedingungen: Attribut editable = false und es ist kein Defaultwert gesetzt.
true = ist nur ein Wert verfügbar, wird dieser eingesetzt und kursiv dargestellt
false = ist nur ein Wert verfügbar, muss dieser manuell eingesetzt werden
bColor optional 0,0,0 bis 255,255,255 Systemfarbe Hintergrundfarbe als RGB-Wert
editable optional, nur für type = combo true, false   true = zu den vorhandenen Werten kann ein beliebiger Wert hinzugefügt werden
false = nur die vorgegebenen Werte können ausgewählt werden
font optional Schriftart-Schnitt-Höhe Systemfont Schriftart, -schnitt und -höhe für die Textdarstellung
hSize optional     Breite des Elements
EEC = Breite in Zeichen
Web-Applikation = Breite in Pixel
hSizeMax optional     Maximale Breite des Elements
EEC = Breite in Zeichen
Web-Applikation = Breite in Pixel
hSizeMaxPx optional     maximale Breite des Elements
EEC = Breite in Pixel
Web-Applikation = Breite in Pixel
hSizeMin optional     Minimale Breite des Elements
EEC = minimale Breite in Zeichen
Web-Applikation = minimale Breite in Pixel
hSizeMinPx optional     Minimale Breite des Elements
EEC = minimale Breite in Pixel
Web-Applikation = minimale Breite in Pixel
hSizePx optional     Breite des Elements
EEC = Breite in Pixel
Web-Applikation = Breite in Pixel
id benötigt beliebig   eindeutige ID, auf die Bezug genommen wird
img nur für type = toggle png, gif, jpg   weist dem Element ein anderes Bild zu
key optional     Feld aus dem der Wert des EOs gelesen wird
link optional     Formel zum Objekt des Navigationsziels
readonly optional true, false   true = Feld kann nur gelesen werden. Bei type = combo kann die Liste nicht aufgeklappt werden.
false = Feld kann auch geschrieben werden. Bei type = combo kann die Liste aufgeklappt und ein Wert ausgewählt werden.
receiver benötigt     Formel zum Objekt
style nur für type = text und radio multi, right, center, left, horizontal, vertical, wrap  

Definiert das Attribut type genauer.

Für type="text" sind folgende Kombinationen möglich:
multi = mehrzeiliges Eingabefeld mit linksbündigem Text

multi right = mehrzeiliges Eingabefeld mit rechtsbündigem Text

multi center = mehrzeiliges Eingabefeld mit zentriertem Text

vertical = mehrzeiliges Eingabefeld mit linksbündigem Text und vertikaler Bildlaufleiste

vertical right = mehrzeiliges Eingabefeld mit rechtsbündigem Text und vertikaler Bildlaufleiste

vertical center = mehrzeiliges Eingabefeld mit zentriertem Text und vertikaler Bildlaufleiste

horizontal = mehrzeiliges Eingabefeld mit linksbündigem Text und horizontaler Bildlaufleiste

wrap = mehrzeiliges Eingabefeld mit linksbündigem Text und automatischem Zeilenumbruch

wrap vertical = mehrzeiliges Eingabefeld mit linksbündigem Text, automatischem Zeilenumbruch und vertikaler Bildlaufleiste

Für type="radio" sind folgende Angaben möglich:

horizontal = horizontal angeordnete Optionsfelder
vertical = vertikal angeordnete Optionsfelder

text nur für type = toggle     Der anzuzeigende Text, dieser kann mit Hilfe der Formelsprache berechnet werden
tooltip optional     Text oder Form-UI des einzublendenden Tooltips (siehe tooltip)
type optional text
combo
radio
check
password
toggle
text Eingabefeldtyp:
text = Textfeld (zulässig für pureTable)
combo = dropDown-Listenfeld (zulässig für pureTable)
radio = Optionsfeld
check = Kontrollkästchen (zulässig für pureTable)
password = verdeckte Passworteingabe
toggle = Schaltfläche mit Toggle-Funktion
values nur für type = combo     Liste von Werten, die in einer Combobox angezeigt werden sollen.
=List{Pair{1,'one'},Pair{2,'two'}}
visible optional     true = Element ist sichtbar
false = Element ist unsichtbar
visibleItemCount optional, nur für type = combo     Anzahl der anzuzeigenden Elemente in einem dropDown-Listenfeld, ohne zu scrollen
vSize optional     Höhe des Elements
EEC = Höhe in Zeichen
Web-Applikation = Höhe in Pixel
vSizeMax optional     Maximale Höhe des Elements
EEC = maximale Höhe in Zeichen
Web-Applikation = maximale Höhe in Pixel
vSizeMaxPx optional     Maximale Höhe des Elements
EEC = maximale Höhe in Pixel
Web-Applikation = maximale Höhe in Pixel
vSizeMin optional     Minimale Höhe des Elements
EEC = minimale Höhe in Zeichen
Web-Applikation = minimale Höhe in Pixel
vSizeMinPx optional     Minimale Höhe des Elements
EEC = minimale Höhe in Pixel
Web-Applikation = minimale Höhe in Pixel
vSizePx optional     Höhe des Elements
EEC = Höhe in Pixel
Web-Applikation = Höhe in Pixel
write optional     Feld des EOs in das der Wert geschrieben wird
Erlaubte Unterelemente Anzahl
tooltip 0..1

Hinweis:

Die Auswahlwerte in DropDown-Listenfeldern müssen immer eindeutig sein! Eine Unterscheidung der angezeigten Werte ist sonst nicht sichergestellt.

Hinweis:

Werden die Attribute hSizeMax und hSizeMaxPx gesetzt, wird hSizeMaxPx angewendet (hSizeMax wird somit ignoriert).

Hinweis:

Ein DropDown-Listenfeld, das nicht editierbar ist zeigt bei der Eingabe von Werten aus der Zwischenablage folgendes Verhalten:
Werte, die denen entsprechen, die in einer Liste vorgegeben sind (Attribut value), werden übernommen, davon abweichende Werte werden ignoriert.

Textfeld:

Das Textfeld wird als Kasten dargestellt, in dem sich ein Text befindet. Die Höhe und Breite des Feldes richtet sich nach dem Inhalt. In diesem Beispiel wird der Text angezeigt, der im Feld "Name" der Komponente gespeichert ist.

Schreibgeschütztes Textfeld:

Das Textfeld wird als grauer Kasten dargestellt, in dem sich ein Text befindet. Durch das Ausgrauen wird angezeigt, dass der Text nicht geändert werden kann.

Hinweis:

Unter Windows 7 variiert die Darstellung des schreibgeschützten Textfelds je nach gewähltem Design. Dies kann zu Darstellungen führen, die nur sehr schlecht lesbar sind.

Textfeld schreibt Kommentar:

Das Textfeld wird als Kasten dargestellt, in den ein Text eingegeben werden kann. In diesem Beispiel wird der eingegebene Text im Feld "Kommentar" des EOs gespeichert.

Textfeld mit begrenzter Breite:

Das Textfeld wird als Kasten mit begrenzter Breite dargestellt, in dem sich der Text Dokumentation befindet. Durch die Begrenzung des Textfelds auf 25 Pixel wird der Text abgeschnitten.

Textfeld mit Link:

Das Textfeld speichert den Wert des Parameters Ort. Der darin befindliche Text wird mit dem Font Arial in der Größe 15 pt dargestellt. Mit gedrückter Taste [Alt] kann dem Link zum Parameter Place gefolgt werden.

Mehrzeiliges Eingabefeld für Text:

Das mehrzeilige Eingabefeld für Text wird als Kasten dargestellt, in den ein mehrzeiliger Text eingegeben werden kann. In diesem Beispiel wird der Text angezeigt, der im Feld "Kommentar" der Komponente gespeichert ist.

Mehrzeiliges Textfeld mit Link:

Das mehrzeilige Textfeld wird als Kasten dargestellt, in dem sich ein mehrzeiliger Text befindet. In diesem Beispiel wird der Text angezeigt, der im Feld Kommentar des EOs gespeichert ist. Mit gedrückter Taste [Alt] kann dem Link zum Parameter Place gefolgt werden.

DropDown-Listenfeld:

Das DropDown-Listenfeld wird als Kasten mit seitlich angeordnetem Pfeilsymbol dargestellt. Durch klicken auf den Pfeil wird eine Liste aufgeklappt. Das Element der Liste, das mit der Maus markiert wird, erscheint anschließend im geschlossenen Listenfeld und wird darin gespeichert.

Editierbares DropDown-Listenfeld:

Das DropDown-Listenfeld wird als Kasten mit seitlich angeordnetem Pfeilsymbol dargestellt. Durch klicken auf den Pfeil wird eine Liste aufgeklappt. Das Element der Liste, das mit der Maus markiert wird, erscheint anschließend im geschlossenen Listenfeld und wird darin gespeichert. Außerdem kann ein beliebiger Wert eingegeben werden, der dann im geschlossenen Listenfeld gespeichert wird. Enthält das Listenfeld einen eingegebenen Wert, schlägt die Hintergrundfarbe des Listenfelds und aller Felder, die diesen Wert ebenfalls anzeigen, um zu gelb.

DropDown-Listenfeld mit Tooltip:

Wird der Mauszeiger über das DropDown-Listenfeld positioniert, erscheint ein Tooltip.

DropDown-Listenfeld mit vorgegebenen Elementen:

Die Elemente der Liste werden als Attribut values mit folgender Syntax definiert:

values="=List{Pair{angezeigterWert,gespeicherterWert}, Pair{angezeigterWert,gespeicherterWert}

DropDown-Listenfeld mit fester Anzahl sichtbarer Elemente:

Das DropDown-Listenfeld zeigt mit dem Attribut visibleItemCount im aufgeklappten Zustand nur eine fest vorgegebene Anzahl von Elementen an. Durch scrollen gelangt man zu weiteren Elementen des DropDown-Listenfelds.

DropDown-Listenfeld setzt den einzigen Wert automatisch ein:

Für einen Parameter kann per Formel nur ein Wert ermittelt werden. Durch Verwendung des Attributs autoselect="true" wird dieser Wert automatisch angezeigt.

DropDown-Listenfeld mit Referenzen auf Komponenten:

Das DropDown-Listenfeld speichert Referenzen auf mechatronische oder disziplinspezifische Komponenten. Die Elemente der Liste werden mit Hilfe der Formelsprache definiert.

Als Wert des Parameters wird eine, von EEC erzeugte, Formel eingesetzt, die prüft, ob die Komponente auch tatsächlich vorhanden ist (siehe Feld Wert in der obigen Abbildung). Ist die Komponente nicht vorhanden, wird durch die Formel der Wert null zurückgegeben.

Die von EEC erzeugte Formel (im Feld Wert des Parameters) für die im Beispiel ausgewählte Komponente ist:

=if existsRef('Dokumentation_UI_ 
Configuration.Mechatronic.Documentation.Station') then ref('Dokumentation_UI_
Configuration.Mechatronic.Documentation.Station') else null endif.

Optionsfelder horizontal:

Optionsfelder werden defaultmäßig horizontal angeordnet. Um die horizontale Anordnung zu erzwingen wird das Attribut style mit dem Wert horizontal definiert.

Der angezeigte Wert und der Wert, der gespeichert wird, können unterschiedlich definiert werden. Dazu wird die folgende Syntax verwendet:

<input type="radio"
values="=List{Pair{X,Y},Pair{X,Y}, Pair{X,Y}}"
receiver="parameter('Component')"/>

X = Wert der angezeigt wird

Y = Wert der gespeichert wird

Optionsfelder mit gleichen Werten für Anzeige und Speichern:

Im folgenden Beispiel werden Optionsfelder definiert, die den gleichen Wert anzeigen, der vom Optionsfeld gespeichert wird. Die Anzahl der Optionsfelder richtet sich nach der Anzahl der möglichen Werte des Parameters. In diesem Beispiel sind für die Himmelsrichtungen vier Werte vorgegeben (North, East, South, West).

Optionsfelder mit unterschiedlichen Werten für Anzeige und Speichern:

Das folgende Beispiel zeigt, wie Parameterpaare definiert werden, um die Werte 1, 2 und 3 anzuzeigen, aber die Werte one, two und three zu speichern.

Optionsfelder vertikal:

Für vertikal angeordnete Optionsfelder wird das Attribut style mit dem Wert vertical definiert.

Kontrollkästchen:

Kontrollkästchen speichern den Wert eines Parameters vom Typ Boolean. Typischerweise wird der Parametername seitlich vom Kontrollkästchen dargestellt.

Schaltfläche mit Toggle-Funktion:

Eine Schaltfläche mit Toggle-Funktion (Einrast-Funktion) speichert den Wert eines Parameters vom Typ Boolean. Wird die Schaltfläche gedrückt, ist der Wert des Parameters true und die Schaltfläche behält ihr gedrücktes Aussehen. Durch erneuten Druck auf die Schaltfläche wechselt der Wert des Parameters zu false und die Schaltfläche nimmt wieder das Aussehen des Ausgangszustands an. Die beiden Zustände werden mit unterschiedlichen Bildern in der Schaltfläche angezeigt.

Mehr: