Sonstige Funktionen

Die sonstigen Funktionen gestatten z.B. die Interaktion mit dem Benutzer durch Verwendung von Nachrichtendialogen.

Sonstige Funktionen		Syntax
MSGBOX - MELDUNG	Öffnet einen Nachrichtendialog. Beispiel: =MSGBOX("Meldungstext"; 0; "Titeltext")	MSGBOX(literal Text; number [Typ]; literal [Titel]) Text: Text der im Nachrichtendialog dargestellt wird. Typ: Typ der Nachrichtenbox. Aus je einer Wertgruppe können die Werte addiert werden. Um einen Nachrichtendialog mit den Schaltflächen OK und Cancel mit dem Warning Icon zu erhalten, ist der Wert 33 (also 1+32) zu übergeben. 0 = OK button only 1 = OK and Cancel buttons 2 = Abort, Retry, and Ignore buttons 3 = Yes, No, and Cancel buttons 4 = Yes and No buttons 5 = Retry and Cancel buttons 16 = Critical Message icon 32 = Warning Query icon 48 = Warning Message icon 64 = Information Message icon 0 = First button is default 256 = Second button is default 512 = Third button is default 768 = Fourth button is default Titel: Titeltext für die Titelzeile des Nachrichtendialogs.
INPUTBOX - EINGABEFELD	Öffnet ein einen Eingabedialog der die Eingabe eines einzeiligen Textes ermöglicht. Der Eingabetext wird bei Betätigen der Schaltfläche OK zurückgegeben. Die Schaltfläche Abbrechen gibt immer eine leere Zeichenkette zurück. Beispiel: =INPUTBOX("Meldungstext"; "Titeltext"; "Textvorbelegung")	INPUTBOX(literal Text; [literal Titel]; [literal Textvorbelegung]; [number xpos]; [number ypos]) Text: Text der im Eingabedialog dargestellt wird. Titel: Titeltext für die Titelzeile des Nachrichtendialogs. Textvorbelegung: Text der nach dem Öffnen des Eingabedialoges bereits vorbelegt wird. xpos: Position des Eingabedialoges auf dem Bildschirm, ausgehen von der oben linken Dialogecke zur oberen linken Bildschirmecke. ypos: Position des Eingabedialoges auf dem Bildschirm, ausgehen von der oben linken Dialogecke zur oberen linken Bildschirmecke.
FILECHOOSER	Öffnet ein einen Dateiauswahldialog (javax.swing.JFileChooser) der dem Benutzer die Auswahl einer Datei oder eines Verzeichnisses ermöglicht. Beispiel: =filechooser("select folder";;; true)"	FILECHOOSER([literal Titel]; [literal Verzeichnis]; [literal Extension]; [boolean directories]) Titel: Der Titel der im Dateiauswahldialog dargestellt wird. Verzeichnis: Das Verzeichnis, dass nach dem Öffnen des Dateiauswahldialog ausgewählt ist. Extension: Der Dateiauswahldialog zeigt nur Dateien an, die die angegebene Dateiendung besitzen. Mehere Dateien können durch das Trennzeichen '|' angegeben werden. Beispiel: .jpg|.gif. directories: besitzt das Parameter den Wert true, so wird die Verzeichnisauwahl aktiviert. Es werden keine Dateien angezeigt und der Benutzer kann nur ein Verzeichnis auswählen. Der Standartwert ist false.
DIRECTORYCHOOSER	Öffnet ein einen Verzeichnisauswahldialog (com.odc.eva3.rt.se.form.SDirectoryChooser) der dem Benutzer die Auswahl eines Verzeichnisses ermöglicht. Beispiel: =directorychooser("select folder")"	DIRECTORYCHOOSER([literal Titel]; [literal Kopf]; [literal Verzeichnis]) Titel: Der Titel der im Verzichnisauswahldialog dargestellt wird. Kopf: Überschrift im oeberen Körperteil des Verzeichnisauswahldialog. Verzeichnis: Das Verzeichnis, dass nach dem Öffnen des Verzeichnisauswahldialog ausgewählt ist.
RGB	Erzeugt ein RGB-Objekt das z.B. für Funktionsaufrufe auf Komponenten verwendet werden kann. Das RGB-Objekt gibt einen nummerischen Wert zurück, der die RGB-Farbe repräsentiert. Beispiel: =RGB(255; 30; 30) Ergebnis: 1974015 Möglicher Einsatz zum Setzen der Hintergrundfarbe einer Komponente: =[Komponentenname].setBackground(RGB(255; 30; 30))	RGB(number Rot; number Grün; number Blau) oder RGB(number Farbe) Rot: Ein Wert zwischen 0 und 255 der den Rotanteil der Farbe bestimmt. Grün: Ein Wert zwischen 0 und 255 der den Grünanteil der Farbe bestimmt. Blau: Ein Wert zwischen 0 und 255 der den Blauanteil der Farbe bestimmt. Farbe: Der Farbwert als dezimale ganzzahl. Entspricht dem nummerischen Wert der von diesem Objekt erzeugt wird.
EVAL	Führt eine Zeichenkette als Ausdruck aus. Ebenfalls, wie Eval-Funktion, werden Zeichenketten ausgeführt, die ein vorangestelltes = Zeichen enthalten. (siehe Verschachtelte Ausdrücke) Beispiel: =EVAL("'Hall' & 'o'") Ergebnis: Hallo	EVAL(literal Ausdruck) Ausdruck: Zeichenkette die als Ausdruck ausgeführt werden soll.
NOP	Die Funktion NOP besitzt keine eigene Funktionalität und keinen Rückgabewert, kann jedoch eine beliebige Anzahl von Parametern diefinieren, die in ihrer vorgegebenen Reihenfolge ausgeführt werden.	NOP([variant Variant]...) Variant: Eine beliebige Anzahl von auszuführenden Parametern.
PRINTLN	Gibt eine Zeichenkette auf der Console (stdout) aus. Diese Funktion ist vor allem zum Testen von Ausdrücken nützlich.	PRINTLN(literal Text) Text: Zeichenkette die auf die Console ausgegeben werden soll.
READFILE	Erlaubt das Einlesen einer Datei, wobei die Datei im Dateisystem liegen oder per HTTP geladen werden kann. Der Rückgabewert ist der eingelesene Text. Diese Funktion ist nicht für Binärdaten geeignet.	READFILE([literal FileName]; [literal Codepage]; [boolean AllowAskUser]) FileName: Der Dateiname der zu ladenden Datei. Wird dieser Teil weggelassen, wird ein Dateiauswahldialog geöffnet. Wurde ein Verzeichnis angegeben, so wird dieses als Standardverzeichnis für den Dateiauswahldialog verwendet. Ebenso sind vorgegebene Verzeichnisse möglich. Codepage: Spezifiziert die Codepage mit der das zu ladenede Dokument interpretiert werden soll. Gängige Codepages sind: "ISO-8859-1", "UTF-8", "UTF-16", "US-ASCII". Wird keine Codepage spezifiziert, wird die Vorgabe des Betriebssystems verwendet. AllowAskUser: Ist die Pfadangabe zu der zu ladenden Datei uneindeutig, wird ein Dateiauswahldialog geöffnet. Besitzt diese Eigenschaft den Wert false, so wird kein Dialog geöffnet. Der Standardwert ist true.
WRITEFILE	Erlaubt das Speichern von Text in eine Datei in das lokale Dateisystem. Diese Funktion ist nicht für Binärdaten geeignet.	WRITEFILE([literal FileName]; [literal Text]; [literal Codepage]; [boolean AllowAskUser]) FileName: Der Dateiname der zu speichernden Datei. Wird dieser Teil weggelassen, wird ein Dateiauswahldialog geöffnet. Wurde ein Verzeichnis angegeben, so wird dieses als Standardverzeichnis für den Dateiauswahldialog verwendet. Ebenso sind vorgegebene Verzeichnisse möglich. Text: Der Text, der in die Datei gespeichert werden soll. Codepage: Spezifiziert die Codepage mit der das zu speichernde Dokument interpretiert werden soll. Gängige Codepages sind: "ISO-8859-1", "UTF-8", "UTF-16", "US-ASCII". Wird keine Codepage spezifiziert, wird die Vorgabe des Betriebssystems verwendet. AllowAskUser: Ist die Pfadangabe zu der zu ladenden Datei uneindeutig, wird ein Dateiauswahldialog geöffnet. Besitzt diese Eigenschaft den Wert false, so wird kein Dialog geöffnet. Der Standardwert ist true.

Funktionen