Графы ввода
Форматы ввода позволяют задавать вид вводимых в графы ввода значений. Для указания типа данных, вводимых в графы ввода используются признаки поля. Существуют следующие признаки:
| & | – | число; |
| * | – | строка; |
| ~ | – | дата (длина – 8 позиций); |
| \ | – | время (длина – 8 позиций); |
| ^ | – | код счета (строка, длина по умолчанию – 20 позиций), при заполнении можно воспользоваться клавишей F2 для подстановки кода счета из плана счетов; |
| *~ | – | графа с вызовом функции – строка с возможностью вызова библиотечной функции. |
| *^ | – | графа с выбором из базы данных – строка с возможностью подстановки значения из DBF-файла. |
Можно использовать два варианта описания форматов граф ввода: с числовым заданием параметров граф ввода, либо с заданием формата ввода по маске:
// Числовое задание параметров граф
<признак_поля><переменная>[(дополнительные_параметры)]
[:длина_поля [:(кол_знак или видимая_длина)]]
// Задание формата по маске
<признак_поля><переменная>[(дополнительные_параметры)][<заполнитель>]
Параметры
- признак_поля
- Указывает на тип графы.
- переменная
- Имя переменной для графы ввода. Способ объявления переменной может определяться с помощью специальных инструкций.
- дополнительные_параметры
- Дополнительные параметры используются только для графы строки, графы счета, графы с вызовом функции и графы с выбором из базы данных. Для сокращения записи здесь могут использоваться строковые подстановки.
- длина_поля
- Общая длина графы.
- кол_знак
- Для числа – количество знаков после запятой (по умолчанию – сколько необходимо).
- видимая_длина
- Для строк – количество видимых символов, которое должно быть меньше общей длины графы. При вводе длинных строк графа горизонтально прокручивается.
- заполнитель
- Заполнитель маски. Тот же символ, что и признак_поля, может повторяться несколько раз. Длина графы будет равна длине строки, необходимой для записи маски.
Параметры длина_поля, кол_знак и кол_строк – числовые значения.
Замечание: при вводе числовой переменной по маске количество знаков после запятой зависит от состояния опции Копейки на закладке Форматы пункта Установка/Настройки Главного меню.
Пример:
Графа ввода с заданием формата ввода по маске:
&сумма&&& // ввод числовой переменной "сумма"
// 9 позиций, 2 знака после запятой: 
*коммент************ // ввод строковой переменной "коммент"
// длина графы – 20 символов: 
*пояснение:200:15 // ввод строки до 200 символов при видимой длине поля – 15
Графы ввода с числовым заданием параметров граф:
&сумма:9:3 // ввод числовой переменной
// 9 позиций, 3 знака после запятой: 
Замечание: при числовом задании параметров графы, она может оказаться больше, чем длина строки, при помощи которой это поле было обозначено. В результате элементы могут "наехать" друг на друга:
&число1:20:3 &число2&&& //
Графа ввода строки
*<переменная>[(<опции>)] [:<длина> [:<видимая длина>]]
Наличие буквы с (скрыть) в строке опций позволяет редактировать текст без показа символов в режиме ввода пароля.
Графа с выбором счета
В графе ввода кода счета можно после имени переменной указать заголовок окна выбора из плана счетов. При задании заголовка окна выбора и опций могут использоваться строковые подстановки.
^<переменная>[(<заголовок>[,<опции>])] [:<длина>]
Наличие буквы п (последний уровень) в строке опций говорит о запрете выбора счетов не последнего уровня (имеющих субсчета).
Пример:
^кодсч("Выберите счет кредита","п"):50
Графа с вызовом функции
Данная графа представляет из себя строку с возможностью вызова библиотечной функции.
Для задания графы с вызовом функции необходимо указать следующие дополнительные параметры:
(<библиотека>,<функция>[, <опции> ])
- библиотека
- Имя файла библиотеки.
- функция
- Имя функции, которая будет вызвана.
- опции
- Строка дополнительных параметров. Наличие буквы з (запрет) в этой строке говорит о запрете ручного ввода в данную графу.
При задании этих параметров могут использоваться строковые подстановки.
При нажатии на кнопку 
, расположенную справа от графы ввода, либо при нажатии на кнопку F2 происходит вызов указанной функции из указанной библиотеки.
Заголовок функции для вызова из графы должен быть строго следующего вида:
ФУНКЦИЯ ТИП_ЛОГИКА: <имя> (ПЕРЕМ ТИП_СТРОКА: <Строка>)
В качестве параметра-переменной Строка передается текущее значение графы ввода. Действие после выхода из функции определяется возвращенным ей результатом: если функция вернула ДА, то в графу ввода подставляется значение параметра-переменной Строка, в противном случае значение графы ввода остается без изменений.
Графа с выбором из базы данных
Строка с возможностью подстановки значения из DBF-файла с помощью клавиши F2.
В этом случае необходимы следующие дополнительные параметры:
(<файл>,<поле>)
- файл
- Имя файла базы данных.
- поле
- Имя поля базы данных.
При задании этих параметров могут использоваться строковые подстановки.
Фактически эта графа ввода является обычной графой ввода строки, но с возможностью подстановки этой строки в соответствии со значением какого-либо поля в базе данных. Вне зависимости от типа поля, результат выбора подставляется в строковом виде.