Многострочное поле ввода
Свойства
| Свойство | Тип* | Область | Описание | Пример | Версия |
|---|---|---|---|---|---|
| Visible | логический | разметка и скрипт | Задает видимость компонента. Если он невидим, его размеры, тем не менее, учитываются в контейнерах | <c:MemoEdit Visible="false"/> void Hide(MemoEdit control) {
control.Visible = false;
}
| - |
| CssClass | строка** | разметка | Задает название CSS класса, стили которого будут применяться к данному компоненту | <c:MemoEdit CssClass="main_row"/> | - |
| Id | строка** | разметка | Задает идентификатор компонента в области видимости данного экрана. Таким образом можно получить доступ к его свойствам из произвольного места разметки или кода контроллера. Из контроллера доступ к компоненту возможен через объявленную переменную с соответствующим типом и именем, совпадающим с указанным в атрибуте Id, либо через свойство Variables | <c:MemoEdit Id="meMain"/> void HideMemo() {
meMain.Visible = false;
}
| - |
| Parent | компонент | разметка и скрипт, только чтение | Возвращает ссылку на родительский компонент. Возвращает null если текущий объект на верху дерева. | void HideParent() {
meMain.Parent.Visible = false;
}
| - |
| Text | строка** | разметка и скрипт | Задает текст, отображаемый в поле ввода. | <c:MemoEdit Text="#helloworld#"/> | - |
| Value | переменная | разметка | Задает свойство объекта, значение которого будет изменяться по мере ввода данных в поле. | <c:MemoEdit Value="$orderitem.Qty"/> | - |
| OnChange | функция | разметка | Задает ссылку на функцию*** из основного контроллера, вызываемую при изменении содержимого поля. Первым параметром в функцию передается ссылка на объект (sender), последующим - объекты переданные в разметке. | <c:MemoEdit OnChange="Memo_Change"/> void Memo_Change(object sender, EventArgs e)
{
MemoEdit ctrl = (MemoEdit)sender;
DConsole.WriteLine(ctrl.Text);
}
| - |
| OnGetFocus | функция | разметка | Задает ссылку на функцию*** из основного контроллера, вызываемую при выборе поля для редактирования. Первым параметром в функцию передается ссылка на объект (sender), последующим - объекты переданные в разметке. | <c:MemoEdit OnGetFocus="Memo_OnFocus"/> void Memo_OnFocus(object sender, EventArgs e)
{
DConsole.WriteLine("Focus acquired");
}
| - |
| OnLostFocus | функция | разметка | Задает ссылку на функцию*** из основного контроллера, вызываемую при окончании редактирования. Первым параметром в функцию передается ссылка на объект (sender), последующим - объекты переданные в разметке. | <c:MemoEdit OnLostFocus="Memo_LostFocus"/> void Memo_LostFocus(object sender, EventArgs e)
{
DConsole.WriteLine("Focus has been lost");
}
| 2.2.2.91 |
| Length**** | число | разметка и скрипт | Задает постусловие: максимальная длина текста в поле при валидации. | <c:MemoEdit /> Length="8" | - |
| Required**** | логический | разметка и скрипт | Задает постусловие: необходимость наличия текста в поле при валидации. | <c:MemoEdit Required="true"/> | - |
| Mask**** | строка** | разметка и скрипт | Задает постусловие: регулярное выражение, применяемое при валидации. Для того, что бы проверять на соответствие всю строку, а не только ее часть, необходимо экранировать выражение символами начала(^) и конца строки($). | <c:MemoEdit Mask="^\d+$"/> | - |
| AutoFocus | логический | разметка | Задает необходимость получения фокуса компонентом при загрузке экрана. Если данное свойство задано для нескольких компонентов на одном экране, фокус получит первый. | <c:MemoEdit AutoFocus="True"/> | - |
| Keyboard | auto |default |numeric |email | url | phone | разметка | Задает тип, выводимой при редактировании, клавиатуры. Если задано значение "auto", вид клавиатуры будет зависеть от типа данных, установленных в свойстве Value. | <c:MemoEdit Keyboard="numeric"/> | - |
| Placeholder | строка** | разметка и скрипт | Задает текст-подсказку, отображаемый в пустом поле. | <c:MemoEdit Placeholder="#search#"/> | - |
| Enabled | логический | разметка и скрипт | Задает доступность компонента для редактирования | <c:EditText Enabled="False"/> meMain.Enabled = false; | 2.4.0.110 |
* - в качестве параметра можно передавать константу, переменную, функцию или свойства соответствующего типа
** - при установке строкового свойства в разметке, применяются особые правила форматирования текста.
*** - первым параметром в функцию передается ссылка на объект (sender), последующим - объекты переданные в разметке.
**** - данные свойства применяются при вводе с использованием визуального компонента SubmitButton.
Методы
| Метод | Описание | Параметры | Пример | Версия |
|---|---|---|---|---|
| Refresh() | Перерисовывает элемент управления, вызов необходим при смене стилей. | void Btn_Click(object sender, EventArgs e)
{
Buttob btn = (Button)sender;
btn.CssStyle = "someNewStyle";
btn.Text = "Style changed";
btn.Refresh();
}
| 3.0.0 | |
| SetFocus() | Устанавливает фокус на данном элементе | void LayoutClick(VerticalLayout container)
{
MemoEdit memoFirst = (MemoEdit)container.Controls[0];
memoFirst.SetFocus();
}
| - |
