Button

Материал из wiki.appsalutecreator.com
Перейти к: навигация, поиск

Общие параметры (см. описание Object)

  • прокликиваемая - Если 1, то кнопка прозрачна для клика мышкой (пропускает объектам под ней). Если 2, то кнопка сама обрабатывает клик, но и пропускает его дальше
  • память - Если 1, то при повторном открытии экрана объект не обновляет свое состояние (помнит текущие параметры, оставшиеся от предыдущего посещения экрана)

Основные параметры

Группа - внешний вид

But.png

(Курсивом в скобках указан id параметра, или состояния)

  • up (res) - Графический ресурс для отображения отжатой кнопки.
  • down (rdn) - Графический ресурс для отображения нажатой кнопки. Может отсутствовать.
  • over (rov) - Графический ресурс для отображения кнопки с мышкой над ней. Может отсутствовать.
  • disable (dis) - Графический ресурс для отображения неактивной кнопки. Может отсутствовать.
  • disable alpha (dis_al) - Можно указать с какой прозрачностью будет кнопка в состоянии disable, например, если кнопку в неактивном состоянии нужно прятать, то ставим 0, и кнопка в состоянии disable будет невидимой.
  • накладывать - Если "1", то графика из параметра down будет накладываться на графику из параметра up при нажатии на кнопу, если "0", то не накладывается.
  • down scale (sd) - Изменяет размеры графического ресурса для отображения нажатой кнопки. Может отсутствовать.
  • over scale (so) - Изменяет размеры графического ресурса для отображения кнопки с мышкой над ней. Может отсутствовать.

Группа - звуки

  • up (sup) - Звуковой ресурс для проигрывания отжатой кнопки. Может отсутствовать.
  • down (sdn) - Звуковой ресурс для проигрывания нажатой кнопки. Может отсутствовать.
  • over (sov) - Звуковой ресурс для проигрывания кнопки с мышкой над ней. Может отсутствовать.

Группа - время

  • невидимости (tmBeg) - Время невидимости перед открытием.
  • открытия (tmOpn) - Время проявления кнопки от полной прозрачности к прозрачности, заданной в модификаторах.
  • закрытия (tmCls) - Время исчезания кнопки до полной прозрачности.
  • Пауза (tmPause) - Время, в течении которого кнопка после нажатия не будет воспринимать клик, но будет выглядеть как активная. Применяется для предотвращения случайного двойного нажатия, например, для кнопки покупки или закрытия окна, когда закрытие длится некоторое время. Этот параметр НЕ применяется для кнопки хинта с перезарядкой.

надпись ID (txtID) - Надпись на кнопке, перетаскивается из редактора строк.

надпись (txt) - Надпись на кнопке. Используется только, если нет графики.

Группа - шрифт

  • имя (fn) - Номер шрифта - целое число, начиная с 0 (порядковый номер шрифта).
  • размер (fs) - Размер шрифта в пикселях.

Дополнительные параметры

  • вернуться назад (back) - 1 - кнопка служит для возврата на предыдущий экран, id экрана для перехода игнорируется.
  • перейти на (scr) - Экран для перехода после клика на кнопку, если условные переходы (ниже) не сработали
  • задержка перехода (delay) - Задержка перед переходом на следующий экран в ms.
  • рейтинг (raiting) - Открывает системное окно с предложением проголосовать, данные берёт из rating.xml

Если на девайсе была нажата кнопка "отрейтинговать", то в опции запишется параметр rating значение 1, если нажата кнопка "позже" - rating 2, "никогда" - rating 3.

  • перезагрузить лэйаут (reload) - 1 - по нажатию на кнопку перезагружает лэйаут
  • отменить текущие закачки (cancel) - 1 - по нажатию на кнопку отменяет все текущие закачки
  • перезапустить текущие закачки (redownload) - 1 - по нажатию на кнопку перезапускает все текущие закачки
  • не предзагружать (pr) - Не загружает в фоновой загрузке графику экрана на которую ведёт кнопка.
  • закрыть приложение (exit) - По нажатию закрывает приложение.
  • восстановить покупки (restore) - 1 - по нажатию на кнопку попытаться восстановить покупки.

Группа - позиционирование

  • горизонтальное (alHor) - 0 - нет выравнивания; 1 - прижать к левому краю; 2 - центр; 3 - к правому
  • вертикальное (alVer) - 0 - нет выравнивания; 1 - прижать к верхнему краю; 2 - центр; 3 - к нижнему

Добавляемые параметры

Button1.PNG

Меню выбора Добавляемые параметры к объектам активируется по правой кнопки мыши.

+.png если был экран - Переходим на определенный экран, если некоторый экран был уже хотя бы раз посещен.

  • был экран- Проверяемый экран, который мы проверяем на то, был ли он уже открыт хотя бы один раз.
  • перейти на - Переходим на этот экран, если экран из предыдущего поля уже открывался.

+.png изменить состояние объекта - При клике на кнопку перевести объект в новое состояние.

  • объект - Изменить состояние у выбранного объекта
  • состояние - Новое состояние для объекта из предыдущего поля.

+.png изменить параметр объекта - Изменить параметр (свойство) объекта при клике на кнопку.

  • объект - Изменить параметр у выбранного объекта
  • параметр - Параметр, который мы изменяем.
  • значение - Новое значение параметра.

+.png изменить состояние объекта - наведение - При наведении на кнопку перевести объект в новое состояние.

  • объект - Изменить состояние у выбранного объекта
  • состояние - Новое состояние для объекта из предыдущего поля.

+.png изменить параметр объекта - наведение - Изменить параметр (свойство) объекта при наведении на кнопку.

  • объект - Изменить параметр у выбранного объекта
  • параметр - Параметр, который мы изменяем.
  • значение - Новое значение параметра.

+.png изменить состояние объекта - отпускание - При отпускании кнопки перевести объект в новое состояние.

  • объект - Изменить состояние у выбранного объекта
  • состояние - Новое состояние для объекта из предыдущего поля.

+.png изменить параметр объекта - отпускание - Изменить параметр (свойство) объекта при отпускании кнопки.

  • объект - Изменить параметр у выбранного объекта
  • параметр - Параметр, который мы изменяем.
  • значение - Новое значение параметра.

+.png изменить графику объекта - При клике на кнопку изменить графический ресурс объекта.

  • объект - Изменить параметр у выбранного объекта
  • параметр - Параметр, который мы изменяем.
  • значение - Новое значение графического ресурса (перетаскивается из редактора ресурсов).

+.png изменить id текста - При клике на кнопку меняет id текста на выбранный у другого объекта.

  • объект - Объект у которого меняется id текста.
  • свойство - Свойство, в которое записывается новый id текста.
  • значение - Новое значение текстового ресурса (перетаскивается из редактора текстов).

+.png изменить id объекта - При клике на кнопку меняет id объекта на выбранный у другого объекта(на пример у инвентаря таким образом указывается id объекта помещаемого в инвентарь).

  • объект - Объект у которого меняется id объекта.
  • свойство - Свойство, в которое записывается новый id объекта.
  • значение - Объект, id которого будет записан.

+.png изменить id экрана объекта - При клике на кнопку меняет id экрана на выбранный у другого объекта(на пример можно использовать для изменения id экрана для перехода у кнопки).

  • объект - Объект у которого меняется id экрана.
  • свойство - Свойство, в которое записывается новый id экрана.
  • значение - Экран, id которого будет записан.

+.png совершить in-app покупку - При клике на кнопку открывается системное окно с предложением совершить in-app покупку.

  • id покупки - Внутренний id покупки для приложения, указывается в объекте store
  • объект(успех) - Объект, которому сообщается об удачной покупке
  • состояние(успех) - Состояние в которое переводится выбранный объект в случае успешной покупки
  • объект(провал) - Объект, которому сообщается о неудачной покупке
  • состояние(провал) - Состояние в которое переводится объект в случае неудачной покупки

+.png скачать загружаемый контент - При клике на кнопку будет совершена попытка скачать контент.

  • url - Ссылка на zip архив с контентом в интернете.
  • объект (успех) - Этому объекту будет сообщено об успехе закачки.
  • состояние (успех) - Это состояние будет установлено объекту при успешной закачке.
  • объект (провал) - Этому объекту будет сообщено о неудаче закачки.
  • состояние (провал) - Это состояние будет установлено объекту при ошибке/отмене закачки.
  • счетчик прогресса - Объект типа счетчик, который будет отображать прогресс загрузки. Крайне желательно, чтобы он имел диапазон 0..100.

+.png открыть внешнюю ссылку - При клике на кнопку открыть ссылку в браузере.

  • id cсылки - Если в опциях не будет найдено ссылки, то сам айдишник будет интерпретироваться как ссылка.
  • id cсылки (iOS) - Если задано, то на iOS устройствах будет использоваться ВМЕСТО основного линка. Ссылка которая открывается на iOS устройствах(может быть в виде itms://.. itms-apps://.. http://...).
  • id cсылки (Android) - Если задано, то на Android устройствах будет использоваться ВМЕСТО основного линка.
  • id cсылки (текстовая база) - Если задано, то будет использоваться ссылка из записи текстовой базы(перетаскивается запись из текстовой базы) ВМЕСТО основного линка. Какая ссылка будет использоваться задаётся при сборке.

+.png отправить письмо - При клике на кнопку вызывается почтовый клиент.

  • адрес - адрес получателя.
  • тема - тема письма.
  • письмо - текст письма.

Примечания и дополнения

Важно помнить:

  • Кнопка реагирует только на отпускание. (В отличии от машины, которая может реагировать как на нажатие, команда click, так и на отпускание, команда touch_up.)

Часто для простых похожих действий используют как кнопки, так и машины. Важно учитывать, на каком этапе тапа они срабатывают (нажатие, удерживание, отпускание) потому, что игрок может очень длительное время удерживать палец на экране.
Можно сделать так, что один тап будет приводить в действие два объекта. Например, тапнуть на машину, которая реагирует на нажатие, а затем перетащить палец на кнопку (или поместить кнопку поверх машины) и отпустить. В таком случае на один тап откликнется и машина, и кнопка.

  • Следует аккуратно использовать кнопки, если у них или их родителей прокликиваемость = 2. В таком случае, если кнопку двигать (например, анимация колыхания), то она потеряет фокус и не будет реагировать на тап.

Состояния

Все состояния:

  • beg - кнопка невидима, при вызове этого состояния она перейдет в open по прохождению времени, указанного в поле времена->невидимости.
  • open - кнопка проявляется по альфе за время, указанном в поле времена->открытия, после чего переходит в up.
  • up - кнопка доступна для нажатия. При нажатии переходит в down. В этом состоянии она отображает ресурс, указанный в поле внешний вид->up.
  • down - вызывается, когда кнопка нажата. Это состояние можно взывать вручную из машины, если надо симулировать нажатие кнопки. В этом состоянии она отображает ресурс, указанный в поле внешний вид->down.
  • ov - вызывается, когда кусор мыши находится над кнопкой. В играх на мобильных телефонах не используется ввиду отсутствия курсора. Кнопка в этом состоянии также доступна для нажатия. В этом состоянии она отображает ресурс, указанный в поле внешний вид->over.
  • close - состояние закрытия, при запуске растворяется по альфе за время, указанном в поле времена->закрытия, после чего переходит в end.
  • end - Кнопка невидима и неактивна.
  • disable - Кнопка видима, но нажать на нее нельзя. В этом состоянии она отображает ресурс, указанный в поле внешний вид->disable.
  • pause - Кнопка временно неактивна. Состояние используется в основном, если надо избежать повторного нажатия на некоторое время, указанное в поле времена->паузы. В этом состоянии она отображает ресурс, указанный в поле внешний вид->disable.
  • highlight_on - В этом состоянии кнопка подствечивается по бленд-альфе на время, указанное в поле времена->подсветки. После чего уходит в состояние highlight_off (его можно вызвать и самому, если сильно приспичит).
  • highlight_off - Окончание подсветки кнопки, после которого она возращается в состояние до подсветки.

Пример реализации

Download