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

Объектный тип ВВОД_ЧИСЛА

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

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

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

Тип ВВОД_ЧИСЛА позволяет создавать поле ввода числа с возможностью вызова калькулятора.

Поля

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

Методы

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

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

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

Вывод на печать элемента типа ВВОД_ЧИСЛА зависит от значения поля печатать. Бордюр поля ввода или кнопки при печати не отображаются.

См. также: