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

Функция БД_СЧИТАТЬ_СТОЛБЕЦ

Функция БД_СЧИТАТЬ_СТОЛБЕЦ позволяет получить ранее добавленное описание столбца из глобального именованного набора.

ФУНКЦИЯ ТИП_СТРОКА: БД_СЧИТАТЬ_СТОЛБЕЦ(ТИП_СТРОКА: имя_набора; ТИП_ЧИСЛО: поз;
                            [; ПЕРЕМ ТИП_СТРОКА: заголовок
                                [; ПЕРЕМ ТИП_ЧИСЛО: длина 
                                    [; ПЕРЕМ ТИП_СТРОКА: опции [, имя_обработчика ] ] ] ] )

Параметры

имя_набора
Глобальное имя набора столбцов.
поз
Позиция столбца в наборе. Нумерация столбцов от 1. Количество столбцов в наборе можно получить функцией БД_КОЛ_СТОЛБЦОВ.
заголовок
Необязательный выходной строковый параметр. Текст заголовка столбца.
длина
Необязательный выходной числовой параметр. Видимая ширина столбца в символах.
опции
Необязательный выходной строковый параметр. Дополнительные параметры столбца, определяемые буквами в строке:
  • Н – (Найти) определяет столбец для поиска. В наборе должен быть только один такой столбец.
  • И – (Игнорировать) столбец присутствует в наборе, но не используется для отображения.
  • Ч – (Чтение) столбец в режиме "только чтение".
  • П – (Подстановка) в диалоге редактирования записи разрешает авто-подстановку при пустом значении поля.
  • З – (Запрет) в диалоге редактирования записи запрещает ручной ввод при изменении значения поля.
  • О – (Отключен) в диалоге редактирования записи отключает использование обработчика. При редактировании поля нет кнопки вызова функции.
имя_обработчика
Необязательный выходной строковый параметр. Идентификатор обработчика выбора значения для данного столбца. По идентификатору выполняется связывание описания столбца с именем библиотеки и функции, которые указываются в параметрах функции БД_РЕДАКТОР. Пустая строка означает, что для поля не используется обработчик.

Возвращаемое значение.

Имя столбца или пустая строка, если не существует указанного набора или указана неверная позиция.

Пример использования

Набор = "Продукты"            
кол = БД_КОЛ_СТОЛБЦОВ(Набор)
ЦИКЛ ДЛЯ (и = 1, кол) // выводим имена всех столбцов в наборе
  имя = БД_СЧИТАТЬ_СТОЛБЕЦ(Набор, и)
  ОТЛАДКА(имя) 
КОНЕЦ_ЦИКЛА

См. также: