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