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

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


lm2:ce:s_panels

Описание панелей

Панели - дочерние элементы окон. На панелях располагаются элементы, которые будут использоваться в процессе работы программы. Файл конфигурации по умолчанию panels_main.xml.

Структура конфигурационного файла

i_s_panels.jpg

Описание атрибутов / свойств элементов

Условные обозначения префиксов в квадратных скобках можно посмотреть в статье «Условные обозначения при описании атрибутов / свойств».

root - корневой элемент, не имеет свойств

root/Text - элемент, свойства которого описывают файл с текстовыми данными. Свойства:

ПрефиксСвойствоОписание
[I STRING]FileNameНазвание файла с расширением

root/Library - элемент свойства которого описывают библиотеку элементов. Свойства:

ПрефиксСвойствоОписание
[I STRING]FileNameНазвание файла с расширением

root/GUI - родительский элемент для всех панелей. Свойства:

ПрефиксСвойствоОписание
[I BOOL=false]LockedНЕТ ДАННЫХ

root/GUI/Panel - элемент, свойства которого задают характеристики панели. Свойства:

ПрефиксСвойствоОписание
[IR STRING ID]IDУникальный идентификатор панели
[IRW FLOAT=VPWidth]WidthШирина панели в пикселях
[IRW FLOAT=VPHeight]HeightВысота панели в пикселях
[I INT=1920]VPWidthШирина вьюпорта, на который будет выводиться панель
[I INT=1080]VPHeightВысота вьюпорта, на который будет выводиться панель
[IRW FLOAT=0.0]LeftКоордината по горизонтали верхнего левого угла панели, задается в пикселях, в пространстве панели (т.е. до применения Scale)
[IRW FLOAT=0.0]TopКоордината по вертикали верхнего левого угла панели, задается в пикселях, в пространстве панели (т.е. до применения Scale)
[IRW FLOAT=1.0]ScaleМасштаб панели. Панель всегда масштабируется от верхнего левого угла
[IR FLOAT=1.0]MaxScaleМаксимальное планируемое увеличение панели. Максимальный масштаб панели вычисляется как Scale * MaxScale
[IRW BOOL=false]IgnoreMouseНеобходимость игнорировать события от мыши
[IRW BOOL=true]CanPressНеобходимость получать события нажатия кнопками мыши
[IRW BOOL=true]VisibleВидимость панели
[IR FLOAT=0.0]MMWidthШирина панели в миллиметрах. Используется для автоматического вычисления масштабов элементов. Если размеры панели и элемента в миллиметрах не равны нулю, а Scale элемента равен нулю, то Scale элемента вычисляется автоматически
[IR FLOAT=0.0]MMHeightВысота панели в миллиметрах
[IRW FLOAT=1.0]OpacityПрозрачность панели. 0.0 - полностью прозрачная, 1.0 - полностью непрозрачная
[RW FLOAT=1.0]ZoomScaleДополнительное масштабирование панели. Масштабируется из центра. Используется для временного увеличения панели и пр.

root/GUI/Panel/Comment - поле, обычно используемое для словесного описания панели. Свойств не имеет.

root/GUI/Panel/Info - информация о готовности панели (для разработчиков). Свойства:

ПрефиксСвойствоОписание
[I BOOL=false PRIV]CompleteГотовность панели
[I BOOL PRIV]AutoНЕТ ДАННЫХ
[I STRING PRIV]LogСообщение в лог платформы

root/GUI/Panel/Entry - конечный элемент на панели: кнопка, текстовое поле и пр. Свойства:

ПрефиксСвойствоОписание
[IR STRING ID]IDУникальный идентификатор элемента
[IR STRING]TypeIDИмя шаблона из библиотеки элементов. Подробнее см. «Библиотека элементов«
[IRW FLOAT=0.0]LeftКоордината по горизонтали верхнего левого угла элемента, задается в пикселях, в пространстве панели (т.е. до применения Scale)
[IRW FLOAT=0.0]TopКоордината по вертикали верхнего левого угла элемента
[ITRW FLOAT]WidthШирина в пикселях
[ITRW FLOAT]HeightВысота в пикселях
[ITR FLOAT]MMWidthШирина в миллиметрах
[ITR FLOAT]MMHeightВысота в миллиметрах
[R FLOAT]RealLeftНЕТ ДАННЫХ
[R FLOAT]RealTopНЕТ ДАННЫХ
[R FLOAT]RealWidthНЕТ ДАННЫХ
[R FLOAT]RealHeightНЕТ ДАННЫХ
[ITRW FLOAT=1.0]ScaleМасштаб элемента
[ITRW FLOAT=0.0]AngleУгол поворота элемента
[ITRW FLOAT=0.0]OriginXТочка, вокруг которой осуществляется поворот
[ITRW FLOAT=0.0]OriginYТочка, вокруг которой осуществляется поворот
[ITRW BOOL=true]CanPressНеобходимость получать события нажатия кнопками мыши
[ITRW BOOL=true]VisibleВидимость элемента
[ITRW BOOL=false]IgnoreMouseНеобходимость игнорировать события от мыш
[ITRW BOOL=false]MouseCheckRealНЕТ ДАННЫХ
[ITRW DOCK=Center]ZoomDockНаправление дополнительного масштабирования
[ITRW FLOAT=1.0]ZoomScaleДополнительное масштабирование панели. Используется для временного увеличения панели и пр.
[I STRING]HeaderНЕТ ДАННЫХ
[I DOCK]MenuDockНЕТ ДАННЫХ
[RW BOOL]ShowMenuНЕТ ДАННЫХ
[R FLOAT]FullScaleНЕТ ДАННЫХ
[W BOOL]OnTopНЕТ ДАННЫХ
[W BOOL]OnUnderНЕТ ДАННЫХ

root/GUI/Panel/Entry/Comment - поле, обычно используемое для словесного описания элемента на панели. Свойств не имеет.

root/GUI/Panel/Entry/PropertySet - поле, используемое для изменения значения свойства по умолчанию для элемента. Все свойства описаны в статье »Библиотека элементов». Свойства:

ПрефиксСвойствоОписание
[I STRING ID]Property Свойство
[I STRING LANG]Value Значение

root/GUI/Panel/Entry/Menu - НЕТ ДАННЫХ

ПрефиксСвойствоОписание
[I STRING ID]IDНЕТ ДАННЫХ

root/GUI/Panel/Entry/Menu/Item - НЕТ ДАННЫХ

ПрефиксСвойствоОписание
[I STRING ID]ItemIDНЕТ ДАННЫХ
[I STRING NAME]NameНЕТ ДАННЫХ

Примеры конфигурационного файла

Пример 1: Пустой проект

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<root>
  <Text FileName="text.xml"/>
  <Library FileName="templates.xml"/>
  <GUI>
    <Panel ID="main" VPWidth="800" VPHeight="480">
      <Comment>Empty project main panel</Comment>
      <Entry ID="bg" TypeID="bg">
        <Comment>Panel background</Comment>
      </Entry>
      <Entry ID="btExit" TypeID="button" Top="300" Left="300"/>
      <Entry ID="Logo" TypeID="logo" Top="60" Left="60"/>
    </Panel>
  </GUI>
</root>
lm2/ce/s_panels.txt · Последнее изменение: 2020/11/30 14:12 (внешнее изменение)