Поле ввода
30.03.2019
Текстовое поле ввода служат для пользовательского ввода, а также для редактирования текста. Для создания текстового поля ввода используется конструктор CreateTextEdit:
app.CreateTextEdit( str text, float width, float height, ([str]) options )
Параметры:
- text - текст надписи
- width - ширина текстовой области
- height - высота текстовой области
- options:
- Опции выравнивания текста внутри области:
- Left – по левому краю
- Right – по правому краю
- Опции управления размером:
- AutoSize – авторасширение или сжатие элемента для подгонки текста
- Опции оформление надписи:
- Bold - жирное начертание
- Lego - оформление в стиле Лего
- Monospace - устанавливает моноширинный шрифт для текста
- NoSpell - отключает проверку правописания и устанавливает моноширинный шрифт
- ReadOnly - запрещает редактирование текста
- Singleline - устанавливает режим однострочного поля ввода
- Underline - задаёт подчёркивание для поля
- Опции общего управления
- AutoSelect - автовыделение текста при выборе поля
- Extract - разрешает в ландшафном режиме отображать полноразмерную клавиатуру
- NoKeyboard - запрещает отображение клавиатуры
- Number - задаёт отображение цифровой клавиатуры
- Phone - задаёт отображение телефонной клавиатуры
- Password - задаёт поле для ввода пароля
- Link - задание метода для движения NXT
Поле ввода по умолчанию имеет прозрачный фон.
Базовый пример
Выполнить в DS
Методы:
- ClearHistory() - очищает историю изменения текста
Выполнить в DS
myObject.ClearHistory());
- GetCursorLine():int - возвращает номер строки, на которой находится курсор
Выполнить в DS
app.ShowPopup( myObject.GetCursorLine() );
- GetCursorPos():int - возвращает позицию курора в символах
Выполнить в DS
app.ShowPopup( myObject.GetCursorPos() );
- GetHtml():str - возвращает текст с тегами
Выполнить в DS
app.ShowPopup( myObject.GetHtml() );
- GetLineCount():int - возвращает количество строк в поле
Выполнить в DS
app.ShowPopup( myObject.GetLineCount() );
- GetLineStart( int line ):int - возвращает номер первого символа строки с заданным номером
Выполнить в DS
app.ShowPopup( myObject.GetLineStart( 1 ) );
- GetLineTop( int line ):float - возвращает смещение строки с заданным номером от верхнего края
Выполнить в DS
app.ShowPopup( myObject.GetLineTop() );
- GetMaxLines():int - возвращает количество строк в поле
Выполнить в DS
app.ShowPopup( myObject.GetMaxLines() );
- GetSelectedText():str - возвращает выделенный текст
Выполнить в DS
app.ShowPopup( myObject.GetSelectedText() );
- GetSelectionEnd():int - возвращает позицию конца выделения
Выполнить в DS
app.ShowPopup( myObject.GetSelectionEnd() );
- GetSelectionStart():int - возвращает позицию начала выделения
Выполнить в DS
app.ShowPopup( myObject.GetSelectionStart() );
- GetText():str - возвращает текст без тегов
Выполнить в DS
app.ShowPopup( myObject.GetText() );
- GetTextSize():int - возвращает размер шрифта
Выполнить в DS
app.ShowPopup( myObject.GetTextSize() );
- GetType():str - возвращает тип объекта
Выполнить в DS
app.ShowPopup( myObject.GetType() );
- InsertText( str text, int start, int end ) - вставляет текст между начальной и конечной позицией с заменой или без замены (при равенстве start и end) строки
Выполнить в DS
myObject.InsertText( 'Новый текст', 0, 0);
- Redo() - возвращает последнюю операцию изменения текста
Выполнить в DS
myObject.Redo();
- ReplaceText( str text, int start, int end ) - осуществяляет замену тескста в поле между начальной и конечной позицией заданным текстом
Выполнить в DS
myObject.ReplaceText( 'Новый текст', 0, 3);
- SetCursorColor( str color ) - устанавливает цвет курсора
Выполнить в DS
myObject.SetCursorColor( 'red' );
- SetCursorPos( int pos ) - устанавливает курсор в заданную позицию
Выполнить в DS
myObject.SetCursorPos( 2 );
- SetHint( str text ) - задаёт этикетку для поля
Выполнить в DS
myObject.SetHint( 'Введите e-mail:' );
- SetHtml( str html ) - устанавливает текст с тегами
Выполнить в DS
myObject.SetHtml( 'Это заголовок!' );
- SetOnChange( callback ) - задаёт ФОВ для вызова после изменения текста
Выполнить в DS
myObject.SetOnChange( function(){ app.ShowPopup( 'Здесь что-то изменилось' );});
- SetOnEnter( callback ) - задаёт ФОВ для обработки нажатия клавиши Enter
Выполнить в DS
myObject.SetOnEnter( function(){ app.ShowPopup( 'Ввод показаний счётчика прошёл успешно!' ); });
- SetOnFocus( callback ) - задаёт ФОВ для обработки получения фокуса
Выполнить в DS
myObject.SetOnFocus( function(){ app.ShowPopup( 'Получен фокус!' ); });
- SetOnTouch( callback ) - задаёт ФОВ для обработки короткого прикосновения
Выполнить в DS
myObject.SetOnTouch( function(){ app.ShowPopup( 'Зачем коснулись вы меня?' ); });
- SetSelection( int start, int stop ) - выделяет тескт между начальной и конечной позицией
Выполнить в DS
myObject.SetSelection( 3, 5 );
- SetText( str text ) - устанавливает текст
Выполнить в DS
myObject.SetText( 'Введите имя' );
- SetTextColor( clr ) - задаёт цвет надписи
Выполнить в DS
myObject.SetTextColor( '#ff0000ff' );
- SetTextSize( size,mode ) - задаёт размер шрифта надписи (mode - 'px','dip','sp','mm', 'pt')
Выполнить в DS
myObject.SetTextSize( 26, 'sp' );
- Undo() - отменяет последнюю операцию изменения текста
Выполнить в DS
myObject.Undo();