Admin: 1 revision imported

2021-02-07T06:55:45Z

1 revision imported

Admin at 17:25, 29 October 2020

2020-10-29T17:25:06Z

New page

{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общая информация и интерфейс Студии]]
* [[Студия/Редактор форм|Редактор форм]]}}
<gallery widths=570px heights=346px>
Studio Treelist 1.png||Пример дерева в редакторе форм Студии
</gallery>

Деревья используются для показа древовидной структуры элементов. Для базы данных такой структурой является структура папок справочников, однако, деревья могут быть использованы и для вывода не относящихся к базе данных значений. Деревья позволяют выделять элементы цветом и параметрами шрифта, содержать флажки для каждой из веток в отдельности, делать недоступными отдельные ветки и пр. Деревья имеют следующие визуальные свойства:
* Закладка '''Визуальные''':
** '''Anchor''' (якоря) -- задает якоря визуального элемента.
** '''Top''', '''Left''' (координата верхнего левого угла) -- задает координату (в точках) верхнего левого угла элемента относительно начала формы.
** '''Width''', '''Height''' (высота и ширина) -- задает высоту и ширину (в точках) элемента.
** '''MaxWidth''', '''MaxHeight''' (максимальная высота и ширина) -- задает максимальную высоту и ширину (в точках) элемента. Иногда бывает необходимо ограничить увеличение размера элемента вместе с размерами формы, так как излишнее увеличение может ухудшить читаемость и осложнить работу с элементом. К примеру, слишком длинное поле редактирования неудобно для чтения и т.п. Максимальные размеры позволяют ограничить увеличение элементов до приемлемых величин.
** '''Layer''' (слой формы) -- задает слой формы, которому принадлежит текущий элемент. Для описания редактора слоев, см. [[Студия/Редактор свойств#Редактор слоев|следующую статью]].
** '''HAlign''' (горизонтальное выравнивание) -- задает горизонтальное выравнивание отображения элементов списка. Текст может выравниваться по левому краю, по правому краю или по середине.
** '''Font''' (шрифт элемента) -- задает шрифт, размер и цвет текста ветки по умолчанию. Для описания редактора шрифтов, см. [[Студия/Редактор свойств#Редактор шрифтов|следующую статью]].
** '''FontColor''' (цвет текста элемента) -- задает цвет текста ветки по умолчанию. Для описания редактора цветов, см. [[Студия/Редактор свойств#Диалог выбора цветов|следующую статью]].
** '''Color''' (цвет фона элемента) -- задает цвет фона элемента. Для описания редактора цветов, см. [[Студия/Редактор свойств#Диалог выбора цветов|следующую статью]].
** '''IsWithCheckboxes''' (отображение флажков) -- устанавливает режим отображения флажков совместно с ветками дерева по умолчанию.
** '''IsNoGridLines''' (запрет отображения линий сетки) -- устанавливает режим, при котором линии сетки дерева не отображаются.
** '''IsDisabled''' (недоступность элемента) -- устанавливает режим недоступности дерева.
** '''IsInvisible''' (невидимость элемента) -- элемент (и его связанных элементы) становится невидимым в рабочем режиме. В режиме редактирования в Студии, элемент по-прежнему отображен.
** '''IfResizeWithParentX''', '''IfResizeWithParentY''' (привязка размеров к группе элементов) -- Особые установки, работающие совместно с ''MaxWidth'' и ''MaxHeight'', если последние заданы для группы элементов, на которой находится текущий элемент, его размеры будут привязаны не к самой форме, а к элементу группы. Без такого условия, невозможно было бы использовать ''MaxWidth'' и ''MaxHeight'' для форм со сложным расположением элементов.
** '''Hint''' (всплывающая подсказка) -- определяет текст всплывающей подсказки при наведении курсора мыши на элемент. Если свойство не задано (пустая строка), подсказка не будет выводиться.
** '''AttachedButtons''' (связанные элементы) -- задает связанные элементы (доп. кнопки) выведенные в заголок списка (либо в другое место списка, в зависимости от установок). Для описания редактора связанных элементов см. [[Студия/Редактор свойств#Редактор связанных элементов|следующую статью]].
* Закладка '''Данные''':
** '''Name''' (наименование) -- задает наименование элемента, с помощью которого к нему можно будет обращаться из программных модулей. Если свойства элемента не будут изменяться программно, наименование можно оставить пустым.
** '''Folders''' (режим отображения папок) -- задает режим отображения папок при выводе справочников, содержащих папки, в список. Доступны следующие режимы отображения:
*** ''Отображать в общей структуре'' -- Папки будут отображаться в общем списке с обычным элементами.
*** ''Отображать вверху списка'' -- Папки будут отображаться до обычных элементов.
*** ''Не отображать'' -- Папки не будут выведены в список.
*** ''Отображать только папки'' -- В список будут выведны только папки.
** '''DBSource''' (привязка к данных базы данных) -- задает привязку данного дерева к сточным частям текущего объекта или свободным объектам базы данных. В зависимости от типа некоторые свойства дерева могут быть автоматически изменены. См. [[Студия/Редактор типов данных|Редактор типов данных]].
** '''Filters''' (начальные фильтры объекта) -- задает начальные фильтры дерева, если оно связано с базой данных. Для описания редактора фильтров см. [[Студия/Редактор свойств#Редактор фильтров табличных элементов|следующую статью]].
** '''InitialSortString''' (начальная установка сортировки) -- задает установку сортировки дерева, если оно связано с базой данных. Для описания редактора установки сортировки см. [[Студия/Редактор свойств#Редактор строки сортировки таблиц|следующую статью]].
** '''ArePeriodicalsIncudedInQuery''' (режим включения в запрос периодических реквизитов) -- задает режим, который автоматически загружает периодические реквизиты, при загрузке объектов в дерево. Обычно периодические реквизиты не загружаются, так как их загрузка связана с дополнительной нагрузкой на базу данных и увеличением времени обновления дерева, однако, если периодические реквизиты используются при информации в ветки дерева (к примеру, в событии ''OnInitLeaf''), этот режим будет ускорять загрузку.
** '''IsDBAutoUpdate''' (режим автоматического обновления) -- задает режим, когда дерево будет периодически обновляться из базы данных. Период обновления по умолчанию задан в [[Студия/Установки проекта|установках проекта]]. Такие режимы нужно использовать с осторожностью, так как они увеличивают нагрузку на базу данных и сеть, при этом большинство обновлений будет бесполезным. Вместо таких режимов, можно, к примеру, использовать функцию [[BroadcastDBUpdate]], после выполнения изменений в важной таблице, за которой ведет наблюдения группа операторов.
** '''IsDefaultControl''' (основной табличный элемент - источник выбора) -- установка указывает на то, что дерево представляет основной список текущих объектов и используется как источник выбора (при открытии формы в режиме выбора), либо для начальной фильтрации или позиционирования (при открытии родительского справочника или подобных операций, система автоматически передает начальный фильтр в форму и она должна знать, в какую таблицу передавать такой фильтр). Установка должна быть активна только для одного табличного элемента формы.
** '''IsDisabledNoParent''' (контроль наличия справочника-родителя) -- установка автоматически делает дерево недоступным, если оно отображает элементы справочников, имеющие родителей (см. [[Объект базы данных]]), которые обычно фильтруются по указанному элементу родителю, и родитель не задан. Когда родитель задан (автоматически или программно с помощью [[Form.ParentElement|ParentElement]]), запрет редактирования автоматически снимается. Установка дана для удобства, чтобы не проверять наличие родителя программно.
** '''doLoadFully''' (полная загрузка дерева) -- установка форсирует загрузку полного дерева папок (иначе элементы будут запрашиваться по мере открытия папок). Это уменьшает нагрузку на базу данных для небольших справочников. Запрос будет выполнен один раз в момент заполнения дерева, а не каждый раз, когда пользователь открывает новую ветку, однако, для больших справочников, такая первая загрузка может выполняться очень долго, в таком случае, не стоит использовать этот режим.
** '''IfNotInSettings''' (не сохраняется в установках формы) -- задает режим, когда при сохранении установок (состояния) формы, состояние данного элемента не будет записано совместно с состоянием других элементов. При чтении установок, этот элемент будет всегда иметь значение по умолчанию. Такой флаг удобно устанавливать, к примеру, для таблиц, содержащих расчетную информацию.
** '''HotKey''' (комбинация клавиш для активации элемента) -- задает комбинация клавиш для мгновенной активации элемента. Для описания редактора горячих клавиш см. [[Студия/Редактор свойств#Редактор горячих клавиш|следующую статью]].
* Закладка '''События''' предоставляет доступ к следующим событиям (см. [[Студия/Визуальные события|Визуальные события]]):
** [[Студия/OnEnter|'''OnEnter''']] -- событие, возникающее при активации списка (получения курсора).
** [[Студия/OnExit|'''OnExit''']] -- событие, возникающее при деактивации списка (потери курсора).
** [[Студия/OnLeafChecking|'''OnLeafChecking''']] -- событие, возникающее в момент (до изменения) установки или снятия пометки (галочки) в ветке дерева.
** [[Студия/OnChangeOrClick|'''OnChangeOrClick''']] -- событие, возникающее при визуальном изменении (перемещении курсора) дерева.
** [[Студия/OnDoubleClick|'''OnDoubleClick''']] -- событие, возникающее при двойном клике по ветке дерева мышью.
** [[Студия/OnRightClick|'''OnRightClick''']] -- событие, возникающее при правом клике по ветке дерева мышью.
** [[Студия/OnKeyPress|'''OnKeyPress''']] -- событие, возникающее при нажатии на клавишу, когда дерево активно.
** [[Студия/OnAttachedButtons|'''OnAttachedButtons''']] -- событие, возникающее при нажатии на связанный элемент (кнопку).
** [[Студия/OnInitLeaf|'''OnInitLeaf''']] -- событие, вызываемое для начальной инициализации ветки дерева. В этот момент можно изменить свойства ветки, добавить флажок, изменить цвет текста и пр.

Дополнительная информация:
* Для работы со свойствами объектов формы из программы, см. статью [[Форма]].
* Для работы с объектом дерева из программы, см. статью [[Дерево]].

← Older revision	Revision as of 06:55, 7 February 2021
(No difference)

Студия/Дерево значений - Revision history

Admin: 1 revision imported

Admin at 17:25, 29 October 2020