Контейнер. Содержит любое количество вложенных компонентов. Каждый вложенный компонент добавляется на экран в соответствие с очередностью, заданной в разметке. Каждый следующий вложенный компонент располагается правее предыдущего. Если сумма высоты и отступов компонента меньше высоты контейнера, расположение по вертикали определяется согласно стилю vertical-align вложенного компонента.
Свойства
Свойство | Тип* | Область | Описание | Пример | Версия |
---|---|---|---|---|---|
Visible | логический | разметка и скрипт | Задает видимость компонента. Если он невидим, его размеры, тем не менее, учитываются в контейнерах | <c:HorizontalLayout Visible="false"/> function Hide(control) { control.Visible = false; } | - |
CssClass | строка** | разметка | Задает название CSS класса, стили которого будут применяться к данному компоненту | <c:HorizontalLayout CssClass="main_row"/> | - |
Id | строка** | разметка | Задает идентификатор компонента в области видимости данного экрана. Таким образом можно получить доступ к его свойствам из произвольного места разметки или скрипта. Так же задавать значение идентификатора необходимо для сохранения состояния некоторых визуальных компонентов при возврате по бизнес процессу. | <c:HorizontalLayout Id="main"/> function HideMain() { $.main.Visible = true; } | - |
Parent | компонент | разметка и скрипт, только чтение | Возвращает ссылку на родительский компонент. Возвращает null если текущий объект на верху дерева. | <c:Button OnClick="$Hide($main.Parent)"/> function HideRoot() { $.main.Parent = false; } | - |
Controls | список | скрипт, только чтение | Возвращает список визуальных компонентов, вложенных в данный контейнер. | function HideContent(sender) { for(control in sender.Controls) control.Visible = false; } | - |
OnClick | функция | разметка | Задает ссылку на функцию из основного контроллера, вызываемую при нажатии на кнопку. Первым параметром в функцию передается ссылка на объект (sender), последующим - объекты переданные в разметке. | <c:HorizontalLayout OnClick="$Print($editOutlet.Text)"/> function Print(sender, text) { Dialog.Message(text); sender.Visible = false; } | - |
OnClickAction | функция | разметка | Задает ссылку на функцию из основного контроллера, вызываемую при нажатии на кнопку. | <c:HorizontalLayout OnClick="$Print($editOutlet.Text)"/> function Print(text) { Dialog.Message(text); } | - |
OnEvent | строка** | Задает событие, при выполнении которого будет вызвана функция, указанная в свойстве OnClick или OnClickAction. Пример события: Back - вызывается при нажатии на кнопку "Назад" в Android устройствах. | <c:HorizontalLayout OnClick="$DoBack()" OnEvent="Back"/> | - | |
SubmitScope | строка** | Задает область валидации. Возможные значения: "all" - проверяются все компоненты окна; список идентификаторов компонентов через знак ";". Обратите внимание: постусловием для контейнеров является выполнение всех постусловий его потомков. | <c:HorizontalLayout OnClick="$DoForward()" SubmitScope="edtName; grValues"/> <c:EditText Id="edtName" Required="true"/> <c:HorizontalLayout Id="grValues"> <c:EditText Id="edtAddress" Length="20"/> <c:EditText Id="edtUrl" Length="10"/> <c:EditText Id="edtPhone" Length="11" Mask="[0-9]+"/> </c:HorizontalLayout> | 2.3.3.107 |
* - в качестве параметра можно передавать константу, переменную, функцию или свойства соответствующего типа
** - при установке строкового свойства в разметке, применяются особые правила форматирования текста.