Erzeugt eine EXPOS-Fehlermeldung. (EXPOS -Funktion!)

Prototype

EX_SetzeFehler( msg[, level[, rtf]] )

Parameter

Parameter	Typ	Bedeutung
msg	string	Fehlermeldung (bis zu 60 Zeichen)
level	number	Optional. 0 = Hinweis, 1 = Warnung, 9 = Abbruch
rtf	string	Optional. Beliebiger Freitext im RTF-Format

Hinweise

Die Funktion funktioniert nur bei Aufruf eines Lua-Skriptes aus EXPOS heraus!
Werden für die Funktionsargumente ungültige Typen gewählt, löst dies einen Laufzeitfehler aus.
Die Fehler werden mit Fehlercode 'Lua-Fehler' in die exmfetab generiert und sind (wie alle anderen EXPOS-Fehler auch) über den Dialog EXMFE10 zu beauskunften.
Ist in der exfetab (EXFE10) kein Fehler mit Fehlercode 'Lua-Fehler' hinterlegt, wird dieser bei Aufruf von EX_SetzeFehler oder bei Auftreten eines Laufzeitfehlers in Lua automatisch erzeugt.
Wird kein zweiter Parameter übergeben, dann wird als Standardwert 9 (=Abbruch) angenommen.
Der dritte Parameter sollte, wenn übergeben, einen Text im RTF-Format enthalten. Liegt der Fehlertext als reiner Text vor, kann er mit Hilfe der Funktion SY_TEXTtoRTF in das RTF-Format umgewandelt werden.

Beispiel

local farbe = EX_Get( "farbe" )                                          -- Merkmal 'farbe' lesen

if farbe ~= "rot" and farbe ~= "gelb" then                               -- Farbe weder rot noch gelb
   EX_SetzeFehler( "Farbe " .. farbe .. " nicht vorhanden!" )            -- kein Level angegeben, also Abbruch (9)
elseif farbe == "gelb" then
   EX_SetzeFehler( "Gelb wurde gewählt, rot ist aber viel schöner!", 0 ) -- 0 = Hinweis
end