Описание кнопок полей ввода
Для задания стандартных и специальных действий, предусмотренных разработчиком формы, имеется возможность указать набор кнопок дополняющих или заменяющих предоставляемые по умолчанию.
По умолчанию поля ввода предоставляют следующие стандартные кнопки:
Тип поля ввода | По умолчанию | Поддерживает |
---|---|---|
строка | - | - |
пароль | отображение символов | отображение символов |
вещественное число | калькулятор | спин, калькулятор |
целое число | спин | спин, калькулятор |
дата | спин, календарь | спин, календарь |
время | спин | спин |
дата и время | спин, календарь | спин, календарь |
код | диалог выбора | диалог выбора |
Стандартные кнопки выполняют предопределенное действие, зависящее от типа поля ввода. Нажатие на специальные кнопки обрабатывается с помощью события команда.
Внешний вид кнопок (как стандартных, так и специальных) может варьироваться в некоторых пределах. Так возможно задание кнопок с текстом, предустановленными картинками и пользовательскими иконками, загружаемыми из файлов.
Набор кнопок описывается строкой. Внешний вид кнопки описывается буквой, символ "*" является признаком стандартного действия. Для текстовых кнопок строка текста задается в квадратных скобках. Для специальных кнопок строка посылаемой команды задается в фигурных скобках. В угловых скобках задается строка текста для всплывающей подсказки при наведении на кнопку.
Буква | Вид кнопки |
---|---|
S | Спин. Выполняет стандартное действие для всех типов полей, кроме строкового. |
T | Текстовая кнопка. Если текст не задан, то содержит "...". Текст задается в квадратных скобках. Т[Поиск] – текстовая кнопка с надписью "Поиск". |
D | Кнопка с изображением стрелки вниз (Down). |
E | Кнопка с изображением знака "равно" (Equal). |
C | Кнопка с изображением галочки (Check). |
V | Кнопка с переключаемым изображением: оторбражать символы/скрывать символы. |
I | Кнопка с пользовательской иконкой. Если имя файла не задано или файла не существует, то отображается иконка по умолчанию. Имя файла относительно папки изображений задается в квадратных скобках. Расширение ico можно не указывать. Пример: I[pictures\myicon.ico]. Также можно использовать встроенные иконки. Пример кнопки с иконкой "Сохранить": I[#SAVE]. |
Для полей ввода текста (при редактировании ячейки, код РЕД_СТРОКА) не осуществляется внутренняя обработка кнопок со стандартным действием. Вместо этого посылаются предустановленные команды: "default_tool" – для кнопки, отмеченной "*", а также "spin_up" и "spin_down" – для верхней и нижней кнопок спина соответственно. Примечание: так как спин использует автоповтор нажатий, то не рекомендуется в обработчике показывать какие-либо окна, а только менять значение поля ввода.
Пустая строка означает использование кнопок по умолчанию. Если надо убрать все кнопки поля ввода, то достаточно задать в качестве строки описания кнопок "-".
Примеры:
-
Строка описания кнопок для поля вещественного числа:
"SE*C{команда_проверки}"
Поле будет содержать спин, кнопку "равно", вызывающую калькулятор и кнопку с галочкой, посылающую команду "команда_проверки". -
Другая строка для поля вещественного числа, где калькулятор вызывается с помощью текстовой кнопки:
"T*[Калькулятор]"
Поле будет содержать кнопку с надписью "Калькулятор", которая калькулятор и будет вызывать. -
Строка, задающая текстовую всплывающую подсказку для кнопки:
"E*<вызывает калькулятор>"
Кнопка с изображением знака "равно" будет иметь всплывающую подсказку с текстом "вызывает калькулятор". -
Строка, задающая текстовую специальную кнопку:
"T[Подставить]{подстановка}"
Кнопка с надписью "Подставить"" будет посылать команду "подстановка". -
Строка, задающая кнопку с пользовательской иконкой и всплывающей подсказкой:
"I[Pics\Общие\Троеточие.ico]{выбор_элемента}<Выбор элемента из справочника>"
Кнопка будет посылать команду "выбор_элемента".
Важно: сначала в строке указывается команда {...}, а затем всплывающая подсказка <...>!