[[http://www.siedler-games.de|{{:sg-link.jpg|}}]]

====== Message ======
\\
\\
<code lua>Message( _text )</code>

Gibt einen Text am oberen linken Bereich des Bildschirms aus. Nach einer bestimmten Zeit FIXME wird dieser wieder automatisch entfernt. ((Um den Text bereits zu einem früheren Zeitpunkt zu löschen kann die Funktion <code lua>GUI.ClearNotes()</code> eingesetzt werden. Vorsicht ist aber trotzdem angebracht, da dies dazu führen kann, dass der Spieler nicht ausreichend Zeit hat, den Text zu lesen!))

\\
===== Beispiel =====

<code lua>
Message( "einzeiliger Text am Bildschirm" )

Message( "und hier ein @cr zweizeiliger Text am Bildschirm" )    -- das Zeichen "@cr" steht für carriage return und erzeugt einen Zeilenumbruch
</code>
\\
Nun können Texte aber auch mit anderen Werten in Verbindung gebracht werden.
\\
<code lua>
function chestCallbackGold()
  local gold = (10 + GetRandom(60)) * 12
  Message("Ihr habt einen Schatz @cr mit " .. gold .. " Talern gefunden.")    -- die Variable gold wird in den Text eingefügt.
  AddGold(gold)
end
</code>
\\
Und Farbe kann auch noch ins Spiel (bzw. in den Text) gebracht werden:
\\
<code lua>
function chestCallbackGold()
  local gold = (10 + GetRandom(60)) * 12
  Message("Ihr habt einen Schatz @cr mit @color:128,128,160 " .. gold .. " Talern @color:255,255,255 gefunden.")
               -- mit "@color" können bestimmte Textstellen eingefärbt werden. Anschließend werden sie auf den Ursprungswert zurück gesetzt.
  AddGold(gold)
end
</code>
\\
Um eine Text, der für die Bildschirmbreite des Editors zu lang ist, auf zwei oder mehr Zeilen aufzuteilen, ist wie folgt vorzugehen:
<code lua>
Message("Ihr habt einen Schatz"..
           " @cr mit @color:128,128,160 " .. gold .. " Talern"..
               " @color:255,255,255 gefunden.")
</code>
\\
\\
===== Siehe auch =====

  * [[tutorials:text_-_umlaute_und_zeilenumbrueche|Text- Umlaute und Zeilenumbrüche]]
  * [[tutorials:textfarben|Textfarben]]
  * [[tutorials:globale_und_lokale_variablen|Global und locale Variablen]]


\\
\\
\\
zurück zur Übersicht:
  * [[s5lua_g:functions-summary|Befehlsreferenz]]
\\
\\