.. _dynamic_composer:

Dynamic
======================

.. seealso::
    Класс метаданных :xsd:class:`DynamicComposer<View.Representation.Layout.DynamicComposer>`

Построение фрейма
-------------------

В данном разделе приводятся примеры-пояснения к зависимости итогового вида фрейма-компоновщика от порядка указания ``dynamicItem``

**Пример 1. Мастер с выравниванием top**

.. code:: xml

    <dynamicItems masterAlign="top">
        <dynamicItem selection="Деталь1" align="client"/>
        <dynamicItem selection="Деталь2" align="right"/>
    </dynamicItems>

.. image:: dynamic_composer_master_top_client_right_example.drawio.png

**Пример 2. Первая деталь с выравниванием top**

.. code:: xml

    <dynamicItems>
        <dynamicItem selection="Деталь1" align="top"/>
        <dynamicItem selection="Деталь2" align="right"/>
    </dynamicItems>

.. image:: dynamic_composer_top_right_example.drawio.png

**Пример 3. Первая деталь с выравниванием right**

.. code:: xml

    <dynamicItems>
        <dynamicItem selection="Деталь1" align="right"/>
        <dynamicItem selection="Деталь2" align="top"/>
    </dynamicItems>

.. image:: dynamic_composer_right_top_example.drawio.png

**Пример 4. Два фрейма с одинаковым выравниванием (right)**

.. code:: xml

    <dynamicItems>
        <dynamicItem selection="Деталь1" align="right"/>
        <dynamicItem selection="Деталь2" align="right"/>
    </dynamicItems>

.. image:: dynamic_composer_right_right_example.drawio.png

Далее следуют примеры внешнего вида формы для разного порядка указания выравнивания детальных фреймов

**Пример 5**

.. code:: xml

    <dynamicItems>
        <dynamicItem selection="Деталь1" align="top"/>
        <dynamicItem selection="Деталь2" align="right"/>
        <dynamicItem selection="Деталь3" align="bottom"/>
    </dynamicItems>

.. image:: dynamic_composer_top_right_bottom_example.drawio.png

**Пример 6**

.. code:: xml

    <dynamicItems>
        <dynamicItem selection="Деталь1" align="top"/>
        <dynamicItem selection="Деталь2" align="bottom"/>
        <dynamicItem selection="Деталь3" align="right"/>
    </dynamicItems>

.. image:: dynamic_composer_top_bottom_right_example.drawio.png

**Пример 7**

.. code:: xml

    <dynamicItems>
        <dynamicItem selection="Деталь1" align="right"/>
        <dynamicItem selection="Деталь2" align="left"/>
        <dynamicItem selection="Деталь3" align="top"/>
        <dynamicItem selection="Деталь4" align="bottom"/>
    </dynamicItems>

.. image:: dynamic_composer_right_left_top_bottom_example.drawio.png

**Пример 8**

.. code:: xml

    <dynamicItems>
        <dynamicItem selection="Деталь1" align="top"/>
        <dynamicItem selection="Деталь2" align="bottom"/>
        <dynamicItem selection="Деталь3" align="right"/>
        <dynamicItem selection="Деталь4" align="left"/>
    </dynamicItems>

.. image:: dynamic_composer_top_bottom_right_left_example.drawio.png


.. attention::

    Данное отображение фреймов на форме отличается от отображения фреймов в Global1: в Global1 нет возможности расположить детали с выравниванием 
    ``left`` или ``right`` на всю высоту формы. Для совместимости, на базах данных Oracle ``left`` и ``right`` фреймы всегда располагаются строго 
    меджу ``top`` и ``bottom`` фреймами

Использование флага `isDetailsOnPanel`
++++++++++++++++++++++++++++++++++++++++

Чтобы разместить набор деталей с выравниванием ``left`` и ``right`` друг под другом (а также ``top`` и ``bottom`` друг за другом), можно использовать 
флаг :xsd:attr:`View.Representation.Layout.DynamicComposer.DynamicItems.isDetailsOnPanel`, чтобы все перечисленные детали были сгруппированы на отдельной
панели внутри фрейма-компоновщика. 

**Пример**

.. code:: xml

    <dynamicItems masterAlign="client" isDetailsOnPanel="true" detailPanelAlign="bottom">
        <dynamicItem selection="Деталь1" align="client"/>
        <dynamicItem selection="Деталь2" align="right"/>
    </dynamicItems>

.. image:: dynamic_composer_isdetailsonpanel_example.drawio.png

Управление размерами фреймов
---------------------------------