Контейнер. Содержит любое количество вложенных компонентов. Каждый вложенный компонент добавляется на экран в соответствие с очередностью, заданной в разметке. При добавлении вложенного компонента, его положение вычисляется на основе заданного для него же стиля dock-align. После этого свободное место, для расположения следующего вложенного компонента, уменьшается на величину занятого предыдущим вложенным компонентом места.
Свойства
| Свойство | Тип* | Область | Описание | Пример | Версия |
|---|---|---|---|---|---|
| Visible | логический | разметка и скрипт | Задает видимость компонента. Если он невидим, его размеры, тем не менее, учитываются в контейнерах | <c:DockLayout Visible="false"/> void Hide(DockLayout control) {
control.Visible = false;
}
| - |
| CssClass | строка** | разметка | Задает название CSS класса, стили которого будут применяться к данному компоненту | <c:DockLayout CssClass="main_row"/> | - |
| Id | строка** | разметка | Задает идентификатор компонента в области видимости данного экрана. Таким образом можно получить доступ к его свойствам из произвольного места разметки или кода контроллера. Из контроллера доступ к компоненту возможен через объявленную переменную с соответствующим типом и именем, совпадающим с указанным в атрибуте Id, либо через свойство Variables | <c:DockLayout Id="dlMain"/> function HideMain() {
((DockLayout)Variables["dlMain"]).Visible = true;
}
| - |
| Parent | компонент | разметка и скрипт, только чтение | Возвращает ссылку на родительский компонент. Возвращает null если текущий объект на верху дерева. | void HideParent(DockLayout control) {
control.Parent.Visible = false;
}
| - |
| Controls | список | скрипт, только чтение | Возвращает список визуальных компонентов, вложенных в данный контейнер. | void HideButtons(DockLayout control) {
foreach(var ctrl in control.Controls)
((Button)ctrl).Visible = false;
}
| - |
| OnClick | функция | разметка | Задает ссылку на функцию обработчик, вызываемую при нажатии на кнопку. Первым параметром в функцию передается ссылка на объект DockLayout (sender) | <c:DockLayout OnClick="DlMain_Click"/> void DlMain_Click(object sender, EventArgs e) {
((DockLayout)sender).Visible = false;
}
| - |
| OnEvent | строка** | разметка | Задает событие, при выполнении которого будет вызвана функция, указанная в свойстве OnClick. Пример события: Back - вызывается при нажатии на кнопку "Назад" в Android устройствах. | <c:DockLayout OnClick="DlMain_Click" OnEvent="Back"/> | - |
* - в качестве параметра можно передавать константу, переменную, функцию или свойства соответствующего типа
** - при установке строкового свойства в разметке, применяются особые правила форматирования текста.
Методы
| Метод | Описание | Параметры | Пример | Версия |
|---|---|---|---|---|
| Refresh() | Перерисовывает элемент управления, вызов необходим при смене стилей. | void Btn_Click(object sender, EventArgs e)
{
Buttob btn = (Button)sender;
btn.CssStyle = "someNewStyle";
btn.Text = "Style changed";
btn.Refresh();
}
| 3.0.0 | |
| AddChild() | Добавляет дочерний элемент управления в контейнер | object | public class MainScreen : Screen
{
public override void OnLoading()
{
DockLayout dl = new DockLayout();
dl.CssStyle = "someStyle";
for(int i=0;i<3;i++)
{
Button btn = new Button();
btn.Text = String.Format("Button {0}", i.ToString());
btn.OnClick += Btn_Click
dl.AddChild(btn);
}
this.AddChild(dl);
}
void BtnClick(object sender, EventArgs e)
{
Button btn = (Button)sender;
DConsole.WriteLine(btn.Text);
}
}
| |
Добавить комментарий