Quelltext der Seite RPGMakerXP/Eventbefehle/Seite 1/Show Choices

{{Vorlage:RPGMakerXPEventBefehleSeite1}}
[[Bild:Showchoices.jpg]]

==Definition und Erklärung==

Mit der '''Show Choices Funktion''' können Sie dem User mehr '''Handlungsfreiheiten''' lassen.
Hierbei beschriften Sie die 4 freien Felder und wählen in der rechten Spalte eine Funktion aus.

Die Funktion '''When Cancel''' gibt an, was passiert, wenn der User ESC drückt.
'''Disallow''' verbietet die Funktion der ESC - Taste.
'''Choice 1-4''' lässt dann automatisch die angegeben Codes ablaufen die im Eventfeld stehn.

Als weiteren Punkt können Sie '''Branch''' benutzen. So wird eine Funktion benutzt die der User nicht auswählen kann und nicht sieht. Also von der der User auch nichts weiß.

==In RGSS==
Um einen Show Choices über RGSS in einem [[RPGMakerXP/Eventbefehle/Seite_3/Script|Call Script]] aufzurufen, wird folgender Code benötigt:

<source lang="ruby">@message_waiting = true
$game_temp.message_proc = Proc.new { 
@message_waiting = false }
$game_temp.message_text = ""
$game_temp.choice_start = 0
@parameters = [§A, §B]
setup_choices(@parameters)
</source>

@parameters ist dabei ein [[RGSS/Tutorials/Rubykurs_1_-_Grundlagen#Arrays|Array]], in welchem die Konditionen für den [[RPGMakerXPVX/Interpreter|Interpreter]] festgelegt werden.

===Erläuterungen===

* §A
Enthält einen [[RGSS/Tutorials/Rubykurs_1_-_Grundlagen#Arrays|Array]] mit Mindestens einer bis Maximal vier Antwortmöglichkeiten.<br>
'''Beispiel:'''
<source lang="ruby">["Ja","Nein","Vielleicht"]</source>
* §B
Bestimmt die '''When Cancel'''-Ausführung.<br>
'''0''': Show Choice darf nicht abgebriochen werden.<br>
'''1-4''': Ausgewählte Antwort bei Abbruch<br>
'''5''': Es passiert was ganz anderes (Branch)

===Antwort überprüfen===
In einem [[RPGMakerXP/Eventbefehle/Seite_1/Conditional_Branch|Conditional Branch]] mit folgendem Code ([[RPGMakerXP/Eventbefehle/Seite_1/Conditional_Branch#Seite_4|Script]] ausgewählt) auf folgende Ergebnisse überprüfen:<br>
'''Code'''
<source lang="ruby">@branch[@list[@index].indent == §3</source>
* §3 kann folgende Werte annehmen:
'''0-3''': Die Antworten 1-4 wurden gewählt (eine davon)<br>
'''4''': Der Branch-Fall tritt ein