eva/3 Application Builder • Entwicklung von eva/3 Anwendungen • Arbeiten mit Ausdrücken

Objekte

Objekte erlauben den Zugriff auf Formulare, Berichte und deren Komponenten. Aufeinander aufbauene Objekte werden durch das "!" getrennt. Funktionen die auf ein Objekt ausgeführt werden, sind immer der letzte Eintrag in der Objektliste und werden durch einen "." getrennt.

Hinweis zur Schreibweise: Vollständig groß geschriebene Objektnamen sind konstante Namen und können ausschließlich mit diesem Begriff verwendet werden, wobei die groß- /kleinschreibung für den auszuführenden Ausdruck keine relevanz hat. Andere Schreibweisen beziehen sich auf die Namen der Objekte auf die zugegriffen werden kann und sind für den individualfall zu ersetzen.

Objekte Syntax

[FORMS]
-
[FORMULARE] Bezeichnet den Zugriff auf eine Menge von verfügbaren Formularen. Das Objekt kann nicht allein eingesetzt werden und besitzt keinen eigenen Wert. Erlaubt den Zugriff auf ein benanntes Formular. [Forms]

[FORMS]![Formularname] Bezeichnet den Zugriff auf ein bestimmtes Formular. Anstelle des Bezeichners Formularname ist der Name des Formulars ohne die Dateiendung ".form" einzutragen. Der Aufruf des Formulars gibt dessen Namen zurück. Erlaubt den Zugriff auf Komponenten und Funktionen des Formulars.

Beispiel: =[FORMS]![Personal]![txt_personen] Der Ergebnisinhalt ist der Wert der Komponente mit dem Namen txt_personen aus dem Formular mit dem Namen Personal. [Formulare]![Formularname]

[Formularname]: Erlaubt den Zugriff auf ein benanntes Formular. Voraussetzung ist das
Objekt [Formulare] als Nachbarobjekt.

[CURRENTFORM]
-
[CURRENTWINDOW] Bezeichnet den Zugriff auf das aktuelle Formular. Im Folgeobjekt kann auf die Komponenten des aktuellen Formulars zugegriffen werden.

Beispiel: =[CURRENTFORM]![txt_personen] Der Ergebnisinhalt ist der Wert der Komponente mit dem Namen txt_personen im aktuellen Formular. [Currentform]

[Komponente] Bezeichnet den Zugriff auf eine Komponente im aktuellen Formular oder Bericht. Der zugriff auf ein anderes, geöffnetes Formular kann über die Objektnachbarn [Formulare]![Formularname] erfolgen. Der Komponentenname wird zwischen Groß- und Kleinschreibung unterschieden.

Der Aufruf der Komponente gibt den aktuell enthaltenen Wert zurück. Der enthaltene Wert kann eine Zahlenwert, eine Zeichenkette, ein Datum, ein boolscher Wert, oder eine Konstante sein. Implementiert die Komponente das Interface ControlledBean, so ist der Rückgabewert der Controlled Value (unformatierte Wert).

Die Formularkomponente erlaubt außerdem den Zugriff auf Funktionen der Komponente.

Beispiel: =[txt_personen] Der Ergebnisinhalt ist der Wert der Komponente mit dem Namen txt_personen im aktuellen Formular. [Komponente]

[Komponente]: Erlaubt den Zugriff auf die benannte Komponente.

[Spaltenname] Bezeichnet den Zugriff auf eine Tabellenspalte der Hauptdatenquelle in Berichten oder eines beliebigen STableElements in Formularen. Besteht eine Komponente mit gleichem Namen im Zugriffsbereich, so wird der Wert der Komponente verwendet. Der Verweis auf eine Tabellenspalte gibt den Spaltenwert der aktuellen Zeile bzw. Cursorposition zurück.

Bei Formularen werden alle vorhandenen STableElemente des Formulars durchsucht. Das erste STableElement mit einem passenden Spaltennamen wird als Datenquelle verwendet. Beispiel: =[personen] Der Ergebnisinhalt ist der Wert der Spalte mit dem Namen personen der Hauptdatenquelle des aktuellen Berichts. [Spaltenname]

[Spaltenname]: Erlaubt den Zugriff auf die benannte Spalte.

[PAGE], [PAGES], [REPORTNAME],
[SYSTEMTIME] Diese Objekte stehen ausschließlich in Berichten zur Verfügung und erlauben den Zugriff auf die aktuelle Seite, die Anzahl der Seiten eines Berichtes und den Berichtsnamen. [Page]: Erlaubt den Zugriff auf die aktuelle Seite.

[Pages]: Erlaubt den Zugriff auf die Gesamtseitenzahl.

[ReportName]: Erlaubt den Zugriff auf den namen des Berichtes.

[SystemTime]: Erlaubt den Zugriff auf die Systemzeit. Die Ausgabe entspricht der Funktion now().

[ROW], [COLUMN] Diese Objekte stehen in Ausdrücken in TBeans innerhalb eines SScrollTable zur Verfügung. Das [ROW] Object kann außerdem in Berichten und Endlosformularen eingesetzt werden.

Beispiel: =[STableElement_personen].getObject([ROW]+1, 1) Der Ergebnisinhalt ist der Wert der ersten Spalte der aktuellen SScrollTable-Zeile des STableElements mit dem namen STableElement_personen. [ROW]: Erlaubt den Zugriff auf die aktuelle Zeile.

[COLUMN]: Erlaubt den Zugriff auf die aktuelle Spalte.

[SYSVARIABLE]![Name]

Das Objekt [Sysvariable] erlaubt den Zugriff auf die eva/3 Systemvariablen, die mit Mit der Javamethode EvaUtils.putVariable(key, value) gesetzt werden können. Die Angabe [Name] ist frei wählbar und enstpricht dem key der eva/3 Systemvariablen.

Wurde die entsprechende Systemvariable nicht gesetzt, so wird der Wert null zurückgegeben. Der Rückgabewert ist ein Objekt vom gleichen Typ, wie er zuvor gesetzt wurde.

Ebenso ist der Zugriff auch auf Java Systemvariable möglich, wenn keine Variable mit gleichem key bereits in der eva/3 Systemvariablen hinterlegt wurde. Auszug aus den Java System-Variablen:

Property	Bedeutung
java.version	Java-Versionsnummer
java.vendor	Herstellerspezifische Zeichenkette
java.vendor.url	URL (also ein Internet-Link) zum Hersteller
java.home	Installationsverzeichnis
java.class.version	Versionsnummer der Java-Klassenbibliothek
java.class.path	Aktueller Klassenpfad
os.name	Name des Betriebssystems
os.arch	Betriebssystem-Architektur
os.version	Versionsnummer des Betriebssystems
file.separator	Trennzeichen für die Bestandteile eines Pfadnamens
path.separator	Trennzeichen für die Laufwerksangabe eines Pfadnamens
line.separator	Zeichenkette für Zeilenschaltung
user.name	Name des angemeldeten Benutzers
user.home	Home-Verzeichnis
user.dir	Aktuelles Arbeitsverzeichnis

[Sysvariable]: Zeigt den Zugriff auf eine eva/3 Systemvariable an.

[Name]: Ist frei zu vergeben und entspricht dem Namen der Systemvariablen unter der ein Wert abgelegt wurde.

Methodenaufrufe auf Objekte

Methoden können auf verschiedene Objektarten ausgeführt werden. Die angegebene Funktion ruft die Objektmethode mit primitiven Datentypargumenten, Zeichenketten oder Objekten auf. Methoden eigener Beans können ebenfalls über Objektfunktionen aufgerufen werden. Objektfunktionen werden durch einen Punkt vom Objekt getrennt und besitzen immer ein abschließendes Klammerpaar für die Parameterübergabe. Objektfunktionen mit dem Rückgabewert void geben immer eine Konstante mit dem Wert null zurück.

Beispiele:

Funktion	Beschreibung	Gültig für
setControlledValue	Setzt den Wert der angegebenen Komponente. Alle Komponenten die das Interface ControlledBean implementieren besitzen diese Methode. Beispiel: =[txt_personen].setControlledValue("Wert")	SScrollTextArea, SComboBox, SCheckBox, SOptionGroup, SFormattedField, P2DBarCode, PBarCode, PCheckBox, PTextArea, PFormattedField
getControlledValue	Gibt den Wert der angegebenen Komponente zurück. Alle Komponenten die das Interface ControlledBean implementieren besitzen diese Methode. Beispiel: =[txt_personen].getControlledValue()	SScrollTextArea, SComboBox, SCheckBox, SOptionGroup, SFormattedField, P2DBarCode, PBarCode, PCheckBox, PTextArea, PFormattedField
setBackground	Setzt die Hintergrundfarbe einer Komponente unter Verwendung eines RGB-Objektes. Die Funktion ruft die gleichname Java-Methode der angegebenen Komponente auf. Das RGB-Objekt kann für alle Methoden verwendet werden, die ein `java.awt.Color` Object erwarten. Beispiel: =[Komponentenname].setBackground(RGB(255; 30; 30))	Alle Komponenten die `javax.swing.JComponent` erweitern.
getObject	Ermittelt den aktuellen Wert aus dem STableElement mit dem Namen STableElement1 und der Spalte mit dem Namen spaltenname. Dies erlaubt den direkten Zugriff auf Daten des aktuellen Datensatzes, ohne das eine Komponente, die die Spalte darstellt, im Formular oder Bericht eingebunden werden muß. Die Funktion ist dem direkten Zugriff über [spaltenname] vorzuziehen, da hierbei gezielt auf die Spalte des gewünschten STableElement zugegriffen wird, und nicht alle STableElemente durchsucht werden müssen. Beispiel: =[STableElement1].getObject("spaltenname")	STableElement

Zugriff auf Felder von Objekten

Um auf ein Feld eines Objektes zuzugreifen, ist der Feldname durch einen Punkt getrennt hinter das gewünschte Objekt zu schreiben. Der Zugriff ist ebenso auf öffentliche (public) Felder, wie auch auf nicht öffentliche (private, protected od. packaged) möglich.

Beispiele:

Feld	Beschreibung	Gültig für
editable	Erlaubt den direkten Zugriff auf das Feld editable des SFormattedField und gibt den boolschen Wert true zurück, wenn das SFormattedField editierbar ist und false, wenn nicht. Beispiel: =[txt_personen].editable	SFormattedField, PFormattedField

Arbeiten mit Ausdrücken