Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Выбор цвета на панели инструментов из палитры или из меню

В разделе продемонстрировано применение компонентов Кнопка панели инструментов, Кнопка выпадающего списка, Диалог выбора цвета и Меню. Для этого в Alpha.HMI реализован проект-пример, который можно скачать для ознакомления.

Предположим, необходимо создать панель инструментов, предназначенную для выбора цвета из палитры или из выпадающего меню. Решим эту задачу, использовав комбинацию компонентов Кнопка панели инструментов, Кнопка выпадающего списка, Диалог выбора цвета и Меню:

Решение реализовано в проекте-примере. Скачайте проект-пример и откройте в Дизайнер Alpha.HMI для наглядности.

К проекту подключен внешний модуль CommonLib. Проект содержит единственную форму MainForm. На ней расположены панель инструментов Toolbar и прямоугольник Output, окрашивающийся в цвет, выбранный с помощью панели инструментов. К панели инструментов Toolbar применен инструмент линейной разметки. Также на форме расположен вспомогательный экземпляр Files компонента Окружение: файлы, служащий для сохранения и открытия файлов.

На панели инструментов размещены:

Запустите проект-пример в рантайм. Обратите внимание, что элементы панели расположены в таком порядке, в каком они перечислены в структуре объекта.

Щелкните ЛКМ по кнопке выбора цвета из палитры (OpenColorDialog, ). Активируется событие MouseClick кнопки, открывающее Диалог выбора цвета в новом окне. Ознакомьтесь с обработчиком события.

  • Свойство Result компонента Диалог выбора цвета записывает результат выбора цвета в экземпляр Результат выбора цвета, расположенный в структуре объекта внутри OpenColorDialog.
  • Свойство okAction компонента Диалог выбора цвета ссылается на команду onClick, расположенную в структуре объекта внутри OpenColorDialog. Команда выполняется в момент нажатия кнопки ОК в окне Диалог выбора цвета и окрашивает прямоугольник Output в цвет, записанный в ColorDialogResult.

Выберите цвет из палитры и нажмите ОК. Прямоугольник окрасится в выбранный цвет.

Теперь щелкните ЛКМ по кнопке, открывающей выпадающее меню (OpenColorMenu, ). Активируется событие MouseClick кнопки, открывающее Диалог выбора цвета в новом окне. Ознакомьтесь с обработчиком события.

  • Свойство Items компонента Меню ссылается на функцию GetMenuItems(), расположенную в структуре объекта внутри OpenColorMenu. Функция описывает пункты меню в виде JSON массива. Ознакомьтесь с описанием функции.
  • Свойство pResult компонента Меню записывает id выбранного пункта меню в экземпляр Результат выбора меню, расположенный в структуре объекта внутри OpenColorMenu.
  • Свойство pAction компонента Меню ссылается на команду onClick, расположенную в структуре объекта внутри OpenColorMenu. Команда выполняется в момент выбора пункта меню и окрашивает прямоугольник Output в цвет, соответствующий id выбранного пункта меню.

Выберите цвет из меню. Прямоугольник окрасится в выбранный цвет.

Сохраним пользовательскую палитру в файл.

  1. Откройте окно выбора цвета вновь и добавьте несколько цветов к пользовательской палитре.
  2. Закройте окно выбора цвета и нажмите Сохранить пользовательскую палитру. Активируется событие ButtonPressed кнопки. Ознакомьтесь с обработчиком события. Экземпляр Files компонента Окружение: файлы формирует путь к файлу colors.json, создаваемом в папке проекта output. Затем туда записывается пользовательская палитра в виде JSON-строки из свойства CustomColors компонента Диалог выбора цвета.
  3. Убедитесь, что файл создался в указанной папке.

Теперь откроем сохраненную пользовательскую палитру из файла.

  1. Закройте окно проекта-примера, а затем вновь запустите в рантайм. Откройте окно выбора цвета: пользовательская палитра будет пуста.
  2. Закройте окно выбора цвета и нажмите Загрузить пользовательскую палитру. Активируется событие ButtonPressed кнопки. Ознакомьтесь с обработчиком события. Экземпляр Files компонента Окружение: файлы извлечет содержимое файла colors.json и поместит его в компонент Диалог выбора цвета в качестве значения свойства CustomColors.
  3. Откройте окно выбора цвета и убедитесь, что пользовательская палитра обновилась.