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

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

Опубликованно: 03.05.2017, 0:10
Последняя редакция, Andry: 03.05.2017 16:42

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

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

Slider(ползунок)

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

Slider

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

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

Свойства:

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

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

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

См. Также: javadoc

ProgressBar

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

ProgressBar

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

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

Свойства:

  • ProgressPercent: Значение прогресса в виде значения от 0 до 1.0. Это делегирует напрямую RangedValueModel ProgressBar.
  • ProgressValue: Необработанное значение относительно диапазона. Это делегирует напрямую RangedValueModel ProgressBar.
  • Model: модель RangedValueModel, которую индикатор выполнения использует как отображаемое значение. По умолчанию устанавливается DefaultRangedValueModel для 0 до 100.
  • Message: текст, отображаемый над областью прогресса.

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

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

См. Также: javadoc

ListBox(Поле списка)(прото)

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

См. Также: javadoc

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

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

См. Также: javadoc

RollupPanel

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

См. Также: javadoc

GridPanel(Панель сетки) (proto)

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

См. Также: javadoc

OptionPanel и State (proto)

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

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

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

ActionButton (proto)

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

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

См. Также: javadoc

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

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