Руководство разработчика

Объектный тип РЕДАКТОР_КНОП

Родительские типы: ЭЛЕМЕНТ → РЕДАКТОР_КНОП.

Реализует интерфейс И_ПОЛЕ_ВВОДА.

Физический объектный тип c закрытой моделью.

Тип РЕДАКТОР_КНОП позволяет создать редактор для ввода однострочного или многострочного текста, дополнительно содержащий заданные кнопки.

Поля

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

Вывод элемента типа РЕДАКТОР_КНОП на печать зависит от значения поля печатать. Бордюр при печати не отображается.

Методы

МетодОписание
ВЫДЕЛИТЬ Позволяет выделить текст в поле ввода.
ВЫДЕЛЕНИЕ Получает позицию выделения текста в поле ввода.
ПОКАЗАТЬ_СООБЩЕНИЕ Отображает всплывающее сообщение в позиции каретки поля ввода.

Обработчики событий

ОбработчикОписание
изменение Вызывается при изменении пользователем текста в редакторе.
после_изменения Позволяет организовать отложенную обработку при изменении пользователем текста в редакторе.
клавиша Вызывается при нажатии пользователем определенных клавиш на клавиатуре.
команда Вызывается при нажатии пользователем функциональных клавиш, выборе пункта контекстного меню, нажатии кнопок редактора, а также получении команды от другого элемента управления.
меню Вызывается при нажатии пользователем правой кнопки мыши или клавиши всплывающего меню на клавиатуре.
нажатие Вызывается при нажатии кнопки в редакторе.

См. также: