Объектный тип РЕДАКТОР_КНОП
Родительские типы: ЭЛЕМЕНТ → РЕДАКТОР_КНОП.
Реализует интерфейс И_ПОЛЕ_ВВОДА.
Физический объектный тип c закрытой моделью.
Тип РЕДАКТОР_КНОП позволяет создать редактор для ввода однострочного или многострочного текста, дополнительно содержащий заданные кнопки.
Поля
| Тип | Поле | Описание | Значение по умолчанию |
|---|---|---|---|
| СТРОКА | текст | Служит для установки и получения редактируемой строки. | |
| ЦЕЛОЕ | гор_выравн | Режим выравнивания текста по горизонтали. Задается одной из констант ГВ_... | ГВ_ЛЕВО |
| СТРОКА | шрифт | Имя шрифта в списке шрифтов формы. | |
| БОРДЮР | бордюр | Параметры окантовки поля ввода. | |
| ЛОГИКА | многострочный | Признак, задающий вид редактора: ДА – редактор для ввода многострочного текста, НЕТ – для ввода однострочного текста. | |
| МИНИ_КНОПКА: @[] | кнопки | Набор кнопок редактора. | |
| ЛОГИКА | вертикально | Расположение кнопок: ДА – кнопки располагаются друг за другом сверху вниз, НЕТ – справа налево. | |
| ЛОГИКА | полн_высота | Автоматическая установка размера кнопок по высоте редактора: ДА – высота кнопок всегда равно высоте редактора, НЕТ – фиксированная высота кнопок. Поле используется только в случае горизонтального расположения кнопок (вертикально = НЕТ). | |
| ЦЕЛОЕ | предел | Предельное число символов вводимого текста. По умолчанию поле инициализируется значением 0, что означает отсутствие ограничений на число вводимых символов. | |
| ЛОГИКА | только_чтение | Задает возможность редактирования текста в редакторе: ДА – текст доступен только для чтения, НЕТ – текст доступен для редактирования. | |
| СТРОКА | подсказка | Текст всплывающей подсказки. | |
| СТРОКА | приглашение | Текст приглашения ввода. Отображается для пустого поля, когда фокус ввода находится на другом элементе. Поддерживается только для однострочного редактора. | |
| ЛОГИКА | файл | Определяет режим ввода пути к файлу или папке. При значении ДА редактор поддерживает следующие возможности:
|
Вывод элемента типа РЕДАКТОР_КНОП на печать зависит от значения поля печатать. Бордюр при печати не отображается.
Методы
| Метод | Описание |
|---|---|
| ВЫДЕЛИТЬ | Позволяет выделить текст в поле ввода. |
| ВЫДЕЛЕНИЕ | Получает позицию выделения текста в поле ввода. |
| ПОКАЗАТЬ_СООБЩЕНИЕ | Отображает всплывающее сообщение в позиции каретки поля ввода. |
Обработчики событий
| Обработчик | Описание |
|---|---|
| изменение | Вызывается при изменении пользователем текста в редакторе. |
| после_изменения | Позволяет организовать отложенную обработку при изменении пользователем текста в редакторе. |
| клавиша | Вызывается при нажатии пользователем определенных клавиш на клавиатуре. |
| команда | Вызывается при нажатии пользователем функциональных клавиш, выборе пункта контекстного меню, нажатии кнопок редактора, а также получении команды от другого элемента управления. |
| меню | Вызывается при нажатии пользователем правой кнопки мыши или клавиши всплывающего меню на клавиатуре. |
| нажатие | Вызывается при нажатии кнопки в редакторе. |