Докуметация Cтарт Статьи Форум Лента Вход
Не официальное русскоязычное сообщество
Главная
    Документация jMonkeyEngine
        jMonkeyEngine Уроки и Документация
            Вклады
                Лемур GUI
                    Комбинированные элементы GUI

Комбинированные элементы GUI

Опубликованно: 03.05.2017, 0:10
Последняя редакция, Andry: 21.09.2017 19:00
  • Комбинированные Элементы GUI
    • Ползунок(Slider)
    • Индикатор выполнения(ProgressBar)
    • Элемент управления Список(ListBox) (прототип)
    • Панель с вкладками(TabbedPanel)
    • RollupPanel
    • Панель сетки(GridPanel) (прототип)
    • OptionPanel и State (прототип)
    • ActionButton (прототип)

Они документированы отдельно, потому что эти элементы являются набор элементов потомков которые составляются вместе, чтобы сформировать более сложный UI элемент. Как правило, они используют только ранее описанные Базовые элементы GUI. Документация здесь будет немного отличаться, так как в ней также будут указаны, какие идентификаторы элементов стиля для потомков становятся чрезвычайно важными при настройке пользовательских стилей.

В большинстве случаев составные элементы также предоставляют прямой доступ к своим потомкам для прямой конфигурации, когда стиль недостаточна или нежелательна. См. element-specific javadoc для геттеров потомков, поскольку они не описаны здесь.

Ползунок(Slider)

Предоставляет регулируемое значение для пользователя в виде скользящей кнопки с кнопками увеличения/уменьшения на каждом конце. Ползунок может быть выровнен по оси x или по оси Y. (Выравнивание по оси Z еще не поддерживается.)

Slider

Пример ползунков по оси X и по оси Y в стиле «glass».

Ползунок получает значение, которое он отображает, отслеживая объект RangedValueModel и задавая меняющееся значение, устанавливая их обратно в эту model. DefaultRangedValueModel предоставляет стандартную поддержку отслеживания, но разработчики могут написать свою собственную реализацию RangedValueModel, которая при необходимости будет напрямую обращается к объектам данных model.

Свойства:

  • model: Объект RangedValueModel, предоставляющий доступ к значению, отображаемому/редактируемому ползунком. По умолчанию используется значение DefaultRangedValueModel от 0 до 100.
  • delta: Величина для регулировки значения вверх или вниз при использовании кнопок увеличения и уменьшения.

Для стилизации каждый ID элемент стиля вложенного элемента, основан на ID элемента, который используется при создании ползунка. По умолчанию это «slider». Относительные ID следующие:

  • .up.button: В ориентации по оси Y это кнопка увеличения
  • .down.button: В ориентации по оси Y это кнопка уменьшения
  • .left.button: В ориентации по оси X это кнопка уменьшения
  • .right.button: В ориентации по оси X это кнопка увеличения
  • .thumb.button: Кнопка, которая перемещается, при изменении значения.
  • .range: Фон области между кнопками увеличения и уменьшения.

См. Также: javadoc

Индикатор выполнения(ProgressBar)

Представляет изменяющееся значение выполнения(прогресса) как полосу, которая заполняется, по мере того как значение достигает 100% относительно некоторого ограниченного диапазона. Компонент также может по желанию отображать непосредственно значение в процентах и/или другой текст, наложенный сверху на индикатор выполнения.

ProgressBar

Пример ProgressBar с сообщением, использующим стиль «glass».

Значение выполнения(прогресса) может быть установлено непосредственно в ProgressBar, который внутри содержит RangedValueModel. В качестве альтернативы, вызовам можно предоставлять свою собственную model RangedValueModel.

Свойства:

  • progressPercent: Значение выполнения(прогресса) в виде значения от 0 до 1.0. Это передается напрямую RangedValueModel ProgressBar.
  • progressValue: Необработанное значение относительно диапазона. Это передается напрямую RangedValueModel ProgressBar.
  • model: модель RangedValueModel, которую индикатор выполнения использует как отображаемое значение. По умолчанию для DefaultRangedValueModel устанавливается от 0 до 100.
  • message: текст, отображаемый над областью выполнения(прогресса).

Для стилизации каждый ID элемент стиля вложенного элемента, основан на ID элемента, который используется при создании ползунка. По умолчанию это «progress». Относительные ID следующие:

  • .container: Фактический ID элемента стиля самого индикатора выполнения. Примечание: это не Контейнер, а Панели, название является семантическим по отношению его отношения к другим элементам потомкам.
  • .label: Метка, отображающая сообщение о ходе выполнения.
  • .value: Панель, которая растет/сжимается, чтобы показать значение прогресса в .container.

См. Также: javadoc

Элемент управления Список(ListBox) (прототип)

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

См. Также: javadoc

Панель с вкладками(TabbedPanel)

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

См. Также: javadoc

RollupPanel

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

См. Также: javadoc

Панель сетки(GridPanel) (прототип)

Отображает сетку из подмножеств панелей, задаваемую с помощью GridModel. GridModel может логически содержать больше значений, чем может отображаться, и GridPanel отображать в определенном мете подмножество, основанное на текущих значениях строки/столбца и visibleRows/visibleColumns. Это основа для GUI элементов списка и таблицы.

См. Также: javadoc

Диалоговое окно и Состояние(OptionPanel и State) (прототип)

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

OptionPanelState предоставляет поддержку необязательных модальных панелей, где панель — это единственное, что может получать сигнал ввод мыши/сенсорного ввода до тех пор, пока оно не будет закрыто. Просто добавьте это один раз к менеджеру состояния, и приложение может легко представить пользователю модальные сообщения, используя удобные методы show() и showError().

См. Также: OptionPanel javadoc и: OptionPanelState javadoc

ActionButton (прототип)

Расширяет Кнопку(Button), чтобы обернуть объект Action. Action являются объекты ‘command’ (в смысле «Command Pattern»), которые дополнительно предоставляют наблюдаемые свойства для названий, значков и.т.д. Это удобно для кода, который должен полностью определить некоторую функцию приложения, не беспокоясь о том, как она будет использоваться или отображается. Одно и то же действие можно использовать в нескольких кнопках, и поэтому это также является удобным способом иметь команды, которые могут изменять состояние своей собственной кнопки, даже если они совместно используются несколькими кнопками. Например, действие, которое появляется в меню, может иметь как значок, так и состояние, а действие, отображаемое на панели инструментов, может иметь только значок. Если они используют один и тот же объект Action, то изменение значка в действии изменит его в обоих местах пользовательского интерфейса.

Это очень похоже на поддержку Action в Swing.

См. Также: javadoc

Добавить комментарий

jMonkeyEngine.ru © 2017. Все права сохранены.