ChooseItem: Unterschied zwischen den Versionen
(Die Seite wurde neu angelegt: „<syntaxhighlight lang="javascript"> chooseItem({"action":action, "callback":callback, "desc1":"", "desc2":"", "needchar":false, "showequipped":false, "itemon":…“) |
(kein Unterschied)
|
Version vom 29. Januar 2015, 11:32 Uhr
chooseItem({"action":action, "callback":callback, "desc1":"", "desc2":"", "needchar":false, "showequipped":false, "itemon":null, "itemtype":null});
Ruft den Wähle-ein-Item-Dialog auf, und liefert das gewählte Item zurück.
action: Textuelle Beschreibung des Vorgangs, also zB "Wähle Waffe, die vergiftet werden soll"
callback: Name der Callback-Javascript-Funktion. Diese hat das folgende Format:
function callback_receiver( itemid, itembezeichnung, characterid )
Alle nachfolgenden Parameter sind optional
desc1, desc2: Zwei Beschreibungstexte für die Aktion, die unterhalb der Hauptbeschreibung eingeblendet werden können
needchar: Ob auch die Auswahl eines Charakters angezeigt werden soll
showequipped: Ob nur ausgerüstete (true) oder nur nicht ausgerüstete (false) Gegenstände angezeigt werden sollen
itemon: wenn gesetzt, filtert es das Inventar nach Items, die eine bestimmte "on"-Eigenschaft haben (zB "applypoison", um nur vergiftbare Waffen anzuzeigen)
itemtype: wenn gesetzt (nur in Kombination mit "on"), werden Items gefiltert, die eine bestimmte "Type"-Eigenschaft auch noch haben (zB on "carry" type "checkbonusap")
Intern wird "chosenItem" gespeichert, aus dem auch noch aktueller Träger, aktueller Slot usw. Abgelesen werden könnten, das ist allerdings noch nicht "exposed". Einzig mittels removeChosenItem kann derzeit auf diesen Datensatz zugegriffen werden.