Документация QSP
Сайт Форум

Эта страница только для чтения. Вы можете посмотреть исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.

[[help:dynamical|Назад: Динамический код]]

====== Меню ======


**QSP** позволяет в любом месте игры вызывать всплывающее меню. Такое меню удобно для расширения функционала различных частей игры. Например, (и это самый распространённый случай), всплывающее меню позволяет "привязать" различные стандартные действия к предметам.

Меню можно вызвать в ЛЮБОМ МЕСТЕ игры. Т.е. нет никакого технического запрета, чтобы вызвать меню прямо из кода локации, или из действия, или из кода гиперссылки. Оператор используется один и тот же.

===== Оператор MENU =====

''**MENU** [$имя_масива]'' - вызов "всплывающего" меню из массива с именем ''[$имя_массива]''.

Прежде, чем использовать данный оператор, необходимо заполнить массив, на основе содержимого которого будут формироваться пункты меню.

Пункты меню — это строковые начения массива с особым форматом записи:
<sxh qsp>
"название пункта меню:название локации:путь к файлу иконки"
</sxh>
	* Название пункта меню — это то, что мы увидим на экране, когда меню будет выведено;
	* название локации — это название локации-обработчика пункта меню, код которой будет выполняться при щелчке на соответствующем пункте меню;
	* путь к файлу иконки — это путь к файлу изображения, которое будет выведено рядом с названием пункта меню.

Таким образом мы должны заполнить массив для того, чтоб создать наши пункты меню:
<sxh qsp>
$stone[0]='Взять камень:takestone'
$stone[1]='Кинуть камень:throwstone'
$stone[2]='Осмотреть камень:lookstone'
</sxh>

Здесь название массива (''**$stone**'') - это название меню, а текстовые значения массива - действия, для которых указаны названия пунктов и названия локаций-обработчиков выбора пунктов меню. При выборе пункта "Взять камень" произойдёт вызов локации с названием "takestone". Аналогично будет происходить с другими пунктами.

Чтобы вывести меню на экран, нужно воспользоваться оператором ''**MENU**'':
<sxh qsp>
menu '$stone'
</sxh>

Поиск символов ":" в пунктах начинается с конца строки, то есть название пункта меню может содержать двоеточия, однако тогда обязательно после названия локации должно стоять двоеточие, даже если вы не используете иконки для пунктов меню.

<sxh qsp>
$stone[0]='Камень: взять:takestone:'
$stone[1]='Камень: кинуть:throwstone:'
$stone[2]='Камень: осмотреть:lookstone:'
</sxh>

Если путь к файлу иконки не указан или указанный файл недоступен, то пункт меню отобразится без иконки.

Пример создания меню с иконками:
<sxh qsp>
! нет иконки
$usr_menu[0] = 'Взять предмет:take_item'
! иконка задана gif-файлом
$usr_menu[1] = 'Положить предмет:put_item:images/put_item.gif'
! иконка задана значением $icon_file
$usr_menu[2] = 'Осмотреть предмет:look_item:<<$icon_file>>'
! пункт меню задан 3-мя переменными
$usr_menu[3] = '<<$name>>:<<$location>>:<<$file>>'

menu 'usr_menu' &! покажет меню из 4-х пунктов
</sxh>

Меню заканчивается на элементе массива со значением ''**""**'' (пустая строка). Т.е. если массив меню состоит из элементов ''"Взять"'',''"Осмотреть"'',''""'',''"Бросить"'', то 2 последних пункта не будут созданы:
<sxh qsp>
$usr_menu[0]='Взять предмет:take_item' & ! этот пункт мы увидим на экране
$usr_menu[1]='Осмотреть предмет:look_item' & ! и этот пункт мы увидим на экране
$usr_menu[2]='' & ! здесь пустое значение, плеер посчитает, что меню кончилось
$usr_menu[3]='Положить предмет:put_item' & ! этот пункт мы не увидим
</sxh>
Чтобы вставить разделитель в меню, вместо соответствующего элемента массива напишите ''**"-:-"**''. Т.е. если нужно поставить разделитель вместо 3-го элемента:
<sxh qsp>
$usr_menu[0]='Взять предмет:take_item'
$usr_menu[1]='Осмотреть предмет:look_item'
$usr_menu[2]='-:-'
$usr_menu[3]='Положить предмет:put_item'
</sxh>

Пример вызова меню из гиперсылки:
<sxh qsp>
	'<a href="EXEC: menu ''$stone''">Камень</a>'
</sxh>

Более подробно о том, как делать меню, можно почитать в соответствующих статьях нашего F.A.Q:
	* [[https://aleksversus.github.io/howdo_faq/pages/kak_sdelat__menju_predmeta_0019.html|Как сделать меню предмета?]]
	* [[https://aleksversus.github.io/howdo_faq/pages/kak_sdelat__raznye_menju_0020.html|Как сделать разные меню?]]
	* [[https://aleksversus.github.io/howdo_faq/pages/kak_sdelat__menju_v_ssylkah_0021.html|Как сделать меню в ссылках?]]
	* [[https://aleksversus.github.io/howdo_faq/pages/kak_peredavat__lokatsijam-punktam_menju_argumenty_0022.html|Как передавать локациям-пунктам меню аргументы?]]
	* [[https://aleksversus.github.io/howdo_faq/pages/kak_delat__kontekstnoe_menju_0023.html|Как делать контекстное меню?]]
	* [[https://aleksversus.github.io/howdo_faq/pages/kak_vstavit__razdelitel__0024.html|Как вставлять разделители?]]
	* [[https://aleksversus.github.io/howdo_faq/pages/kak_vstavit__kartinki_v_menju_0025.html|Как вставлять картинки в меню?]]

===== Порядок работы оператора MENU =====

Когда плеер встречает оператор ''**MENU**'' в коде, он выводит на экран всплывающее меню, сформированное на основе указанного массива, и прерывет выполнение кода, ожидая действий игрока.

Пока ни один из пунктов меню не выбран, или пока игрок не щёлкнул в области за пределами меню, дальнейший код не выполняется.

Если игрок щёлкнул по одному из пунктов меню, вызывается локация, соответствующая данному пункту меню. Эта локация назвается локцией-обработчиком выбранного пункта меню. При этом вызов локации осуществляется так же, как осуществлялся бы при вызове этой локации с помощью оператора ''**[[help:organizing|GOSUB]]**''.

После вызова локации продолжается выполнение кода со следующей команды после ''**MENU**''.

В локацию-обработчик выбранного пункта меню передаётся аргумент - позиция выбранного пункта. Этот аргумент можно получить из ''ARGS[0]''. Позиции пунктов меню нумеруются с 1.

Если игрок не выбрал ни одного пункта меню и щёлкнул по области вне меню, просто продолжается выполнение кода со следующей команды после ''**MENU**''.

[[help:sound|Вперёд: Звук]]
Документация QSPСайтФорум

Инструменты пользователя

Инструменты сайта

Инструменты страницы

Документация QSP
Сайт Форум
