Функция БД_ДОБАВИТЬ_СТОЛБЕЦ
Функция БД_ДОБАВИТЬ_СТОЛБЕЦ позволяет добавить описание столбца в именованный набор столбцов для последующего использования функциями БД_РЕДАКТОР и БД_ВЫБОР.
ФУНКЦИЯ БД_ДОБАВИТЬ_СТОЛБЕЦ(ТИП_СТРОКА: имя_набора, имя_поля
[, заголовок
[; ТИП_ЧИСЛО: длина
[; ТИП_СТРОКА: опции
[, имя_обработчика
[; ТИП_ЧИСЛО: поз ] ] ] ] ] )
Параметры
- имя_набора
- Глобальное имя набора столбцов. Если указанного набора не существует, то он создается автоматически.
- имя_поля
- Имя поля в таблице базы данных, которое будет отображаться в данном столбце. Регистр символов в именах полей роли не играет. В наборе не может содержаться полей с одинаковыми именами.
- заголовок
- Необязательный строковый параметр. Текст заголовка столбца. Если параметр не указан, то в качестве заголовка используется имя поля в верхнем регистре.
- длина
- Необязательный числовой параметр. Видимая ширина столбца в символах. Если не указана или указана как 0, то используется размер поля, заданных в базе данных.
- опции
- Необязательный строковый параметр. Дополнительные параметры столбца, задаваемые буквами в строке:
- Н или * – (Найти) определяет столбец для поиска. В наборе должен быть только один такой столбец.
- И – (Игнорировать) столбец присутствует в наборе, но не используется для отображения.
- Ч или % – (Чтение) столбец в режиме "только чтение".
- П – (Подстановка) в диалоге редактирования записи разрешает авто-подстановку при пустом значении поля.
- З – (Запрет) в диалоге редактирования записи запрещает ручной ввод при изменении значения поля.
- О – (Отключен) в диалоге редактирования записи отключает использование обработчика. При редактировании поля нет кнопки вызова функции.
- имя_обработчика
- Необязательный строковый параметр. Идентификатор обработчика выбора значения для данного столбца. По идентификатору выполняется связывание описания столбца с именем библиотеки и функции, которые указываются в параметрах функции БД_РЕДАКТОР. Пустая строка означает, что для поля не используется обработчик.
- поз
- Необязательный числовой параметр. Позиция добавляемого столбца в наборе. Если параметр не указан, то столбец добавляется в конец списка. Если указана позиция 1, то столбец добавляется в начало списка.
Замечание
Т.к. наборы столбцов являются глобальными, то перед добавлением столбцов в набор необходимо вызвать функцию БД_СБРОС_СТОЛБЦОВ для очистки предыдущего состояния.
Пример использования
Набор = "Продукты" БД_СБРОС_СТОЛБЦОВ(Набор) БД_ДОБАВИТЬ_СТОЛБЕЦ(Набор, "COD", "Код") БД_ДОБАВИТЬ_СТОЛБЕЦ(Набор, "NAIM", "Название", 0, "", "ОбрНазвания") БД_ДОБАВИТЬ_СТОЛБЕЦ(Набор, "NETTO", "Вес нетто", 0, "", "ОбрВеса") БД_ДОБАВИТЬ_СТОЛБЕЦ(Набор, "BRUTTO", "Вес брутто", 0, "", "ОбрВеса")