Различия

Показаны различия между двумя версиями страницы.

--- lm2:ce:s_panels [2020/08/03 13:12]
ruben [Структура конфигурационного файла]
+++ lm2:ce:s_panels [2020/11/30 14:12] (текущий)
@@ Строка 1: / Строка 1: @@
 ===== Описание панелей =====
-Панели - дочерние элементы окон. На панелях располагаются элементы, которые будут использоваться в процессе работы программы. Файл конфигурации по умолчанию **panels_main.xml**. Условные обозначения префиксов в квадратных скобках можно посмотреть в статье "[[:lm2:ce:s_desc|Условные обозначения при описании атрибутов / свойств]]".
+Панели - дочерние элементы окон. На панелях располагаются элементы, которые будут использоваться в процессе работы программы. Файл конфигурации по умолчанию **panels_main.xml**.
 ==== Структура конфигурационного файла ====
+{{:lm2:ce:i_s_panels.jpg?direct&|i_s_panels.jpg}}
+==== Описание атрибутов / свойств элементов ====
+Условные обозначения префиксов в квадратных скобках можно посмотреть в статье "[[:lm2:ce:s_desc|Условные обозначения при описании атрибутов / свойств]]".
+**root **- корневой элемент, не имеет свойств
+**root/Text** - элемент, свойства которого описывают файл с текстовыми данными. Свойства:
+^Префикс^Свойство^Описание|
+|[I STRING]|FileName|Название файла с расширением|
+**root/Library** - элемент свойства которого описывают библиотеку элементов. Свойства:
+^Префикс^Свойство^Описание|
+|[I STRING]|FileName|Название файла с расширением|
+**root/GUI** - родительский элемент для всех панелей. Свойства:
+^Префикс^Свойство^Описание|
+|[I BOOL=false]|Locked|<font inherit/inherit;;#c0392b;;inherit>НЕТ ДАННЫХ</font>|
+**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|<font inherit/inherit;;#c0392b;;inherit>НЕТ ДАННЫХ</font>|
+|[I STRING PRIV]|Log|Сообщение в лог платформы|
+**root/GUI/Panel/Entry** - конечный элемент на панели: кнопка, текстовое поле и пр. Свойства:
+^Префикс^Свойство^Описание|
+|[IR STRING ID]|ID|Уникальный идентификатор элемента|
+|[IR STRING]|TypeID|Имя шаблона из библиотеки элементов. Подробнее см. "[[:lm2:ce:s_templates|Библиотека элементов]]"|
+|[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|<font inherit/inherit;;#c0392b;;inherit>НЕТ ДАННЫХ</font>|
+|[R FLOAT]|RealTop|<font inherit/inherit;;#c0392b;;inherit>НЕТ ДАННЫХ</font>|
+|[R FLOAT]|RealWidth|<font inherit/inherit;;#c0392b;;inherit>НЕТ ДАННЫХ</font>|
+|[R FLOAT]|RealHeight|<font inherit/inherit;;#c0392b;;inherit>НЕТ ДАННЫХ</font>|
+|[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|<font inherit/inherit;;#c0392b;;inherit>НЕТ ДАННЫХ</font>|
+|[ITRW DOCK=Center]|ZoomDock|Направление дополнительного масштабирования|
+|[ITRW FLOAT=1.0]|ZoomScale|Дополнительное масштабирование панели. Используется для временного увеличения панели и пр.|
+|[I STRING]|Header|<font inherit/inherit;;#c0392b;;inherit>НЕТ ДАННЫХ</font>|
+|[I DOCK]|MenuDock|<font inherit/inherit;;#c0392b;;inherit>НЕТ ДАННЫХ</font>|
+|[RW BOOL]|ShowMenu|<font inherit/inherit;;#c0392b;;inherit>НЕТ ДАННЫХ</font>|
+|[R FLOAT]|FullScale|<font inherit/inherit;;#c0392b;;inherit>НЕТ ДАННЫХ</font>|
+|[W BOOL]|OnTop|<font inherit/inherit;;#c0392b;;inherit>НЕТ ДАННЫХ</font>|
+|[W BOOL]|OnUnder|<font inherit/inherit;;#c0392b;;inherit>НЕТ ДАННЫХ</font>|
+**root/GUI/Panel/Entry/Comment** - поле, обычно используемое для словесного описания элемента на панели. Свойств не имеет.
+**root/GUI/Panel/Entry/PropertySet **- поле, используемое для изменения значения свойства по умолчанию для элемента. Все свойства описаны в статье "[[:lm2:ce:s_templates|Библиотека элементов]]". Свойства:
+^Префикс^Свойство^Описание|
+|[I STRING ID]|**Property** |Свойство|
+|[I STRING LANG]|**Value** |Значение|
+**root/GUI/Panel/Entry/Menu** - <font inherit/inherit;;#c0392b;;inherit>НЕТ ДАННЫХ</font>
+^Префикс^Свойство^Описание|
+|[I STRING ID]|ID|<font inherit/inherit;;#c0392b;;inherit>НЕТ ДАННЫХ</font>|
+**root/GUI/Panel/Entry/Menu/Item **- <font inherit/inherit;;#c0392b;;inherit>НЕТ ДАННЫХ</font>
+^Префикс^Свойство^Описание|
+|[I STRING ID]|ItemID|<font inherit/inherit;;#c0392b;;inherit>НЕТ ДАННЫХ</font>|
+|[I STRING NAME]|Name|<font inherit/inherit;;#c0392b;;inherit>НЕТ ДАННЫХ</font>|
+==== Примеры конфигурационного файла ====
+Пример 1: Пустой проект
+<code xml>
+<?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>
+</code>

Lambda-Mu Wiki

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

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

Различия

Инструменты страницы