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

Описание кнопок полей ввода

Для задания стандартных и специальных действий, предусмотренных разработчиком формы, имеется возможность указать набор кнопок дополняющих или заменяющих предоставляемые по умолчанию.

По умолчанию поля ввода предоставляют следующие стандартные кнопки:

Тип поля вводаПо умолчаниюПоддерживает
строка--
парольотображение символовотображение символов
вещественное числокалькуляторспин, калькулятор
целое числоспинспин, калькулятор
датаспин, календарьспин, календарь
времяспинспин
дата и времяспин, календарьспин, календарь
коддиалог выборадиалог выбора

Стандартные кнопки выполняют предопределенное действие, зависящее от типа поля ввода. Нажатие на специальные кнопки обрабатывается с помощью события команда.

Внешний вид кнопок (как стандартных, так и специальных) может варьироваться в некоторых пределах. Так возможно задание кнопок с текстом, предустановленными картинками и пользовательскими иконками, загружаемыми из файлов.

Набор кнопок описывается строкой. Внешний вид кнопки описывается буквой, символ "*" является признаком стандартного действия. Для текстовых кнопок строка текста задается в квадратных скобках. Для специальных кнопок строка посылаемой команды задается в фигурных скобках. В угловых скобках задается строка текста для всплывающей подсказки при наведении на кнопку.

БукваВид кнопки
SСпин. Выполняет стандартное действие для всех типов полей, кроме строкового.
TТекстовая кнопка. Если текст не задан, то содержит "...". Текст задается в квадратных скобках. Т[Поиск] – текстовая кнопка с надписью "Поиск".
DКнопка с изображением стрелки вниз (Down).
EКнопка с изображением знака "равно" (Equal).
CКнопка с изображением галочки (Check).
VКнопка с переключаемым изображением: оторбражать символы/скрывать символы.
IКнопка с пользовательской иконкой. Если имя файла не задано или файла не существует, то отображается иконка по умолчанию. Имя файла относительно папки изображений задается в квадратных скобках. Расширение ico можно не указывать. Пример:
I[pictures\myicon.ico].
Также можно использовать встроенные иконки. Пример кнопки с иконкой "Сохранить":
I[#SAVE].

Для полей ввода текста (при редактировании ячейки, код РЕД_СТРОКА) не осуществляется внутренняя обработка кнопок со стандартным действием. Вместо этого посылаются предустановленные команды: "default_tool" – для кнопки, отмеченной "*", а также "spin_up" и "spin_down" – для верхней и нижней кнопок спина соответственно. Примечание: так как спин использует автоповтор нажатий, то не рекомендуется в обработчике показывать какие-либо окна, а только менять значение поля ввода.

Пустая строка означает использование кнопок по умолчанию. Если надо убрать все кнопки поля ввода, то достаточно задать в качестве строки описания кнопок "-".

Примеры:

  1. Строка описания кнопок для поля вещественного числа:
    "SE*C{команда_проверки}"
    Поле будет содержать спин, кнопку "равно", вызывающую калькулятор и кнопку с галочкой, посылающую команду "команда_проверки".
  2. Другая строка для поля вещественного числа, где калькулятор вызывается с помощью текстовой кнопки:
    "T*[Калькулятор]"
    Поле будет содержать кнопку с надписью "Калькулятор", которая калькулятор и будет вызывать.
  3. Строка, задающая текстовую всплывающую подсказку для кнопки:
    "E*<вызывает калькулятор>"
    Кнопка с изображением знака "равно" будет иметь всплывающую подсказку с текстом "вызывает калькулятор".
  4. Строка, задающая текстовую специальную кнопку:
    "T[Подставить]{подстановка}"
    Кнопка с надписью "Подставить"" будет посылать команду "подстановка".
  5. Строка, задающая кнопку с пользовательской иконкой и всплывающей подсказкой:
    "I[Pics\Общие\Троеточие.ico]{выбор_элемента}<Выбор элемента из справочника>"
    Кнопка будет посылать команду "выбор_элемента".
    Важно: сначала в строке указывается команда {...}, а затем всплывающая подсказка <...>!

См. также: