Глава 29
Работа с Таблицей Значений

• Контекст работы с Таблицей Значений
  • Атрибуты Таблицы Значений
• НомерСтроки
• <ИдентификаторКолонки>
• Методы объекта Таблица Значений
• КоличествоКолонок
• НоваяКолонка
• ВставитьКолонку
• УдалитьКолонку
• УстановитьПараметрыКолонки
• ПолучитьПараметрыКолонки
• КоличествоСтрок
• НоваяСтрока
• УдалитьСтроку
• УдалитьСтроки
• ВыбратьСтроки
• ПолучитьСтроку
• ВыбратьСтроку
• ПолучитьСтрокуПоНомеру
• СдвинутьСтроку
• УстановитьЗначение
• ПолучитьЗначение
• НайтиЗначение
• Сортировать
• Очистить
• Итог
• Заполнить
• Свернуть
• Выгрузить
• Загрузить
• ВидимостьКолонки
• ТекущаяСтрока
• ТекущаяКолонка
• Фиксировать
• ВыводитьПиктограммы
• Пример использования объекта Таблица Значений

Объект типа «ТаблицаЗначений» ~ это средство языка (не сохраняемый в информационной базе объект), которое позволяет строить «динамические массивы» и манипулировать ими (добавлять, редактировать, удалять элементы, сортировать). Таблица значений может быть наполнена значениями любого типа, т. е. в одной таблице типы хранимых значений могут быть разными. Таблица значений может использоваться и как простой двумерный массив (матрица) значений и как таблица строк определенной структуры, когда колонки типизованы и имеют идентификаторы.

Специальный элемент формы диалога «ТаблицаЗначений» является интерфейсным средством отображения и манипулирования этим объектом в формах диалогов. При формировании пользовательского интерфейса прикладной задачи довольно часто возникают ситуации, когда для удобства работы пользователя необходимо дать ему возможность выбирать какое-либо значение из заранее подготовленной таблицы значений. Возможности работы со справочниками, журналами и перечислениями предоставляют достаточно мощные средства выбора этих объектов. Однако, существует также необходимость в выборе значений из таблиц, сформированных и отсортированных нестандартным образом, которые невозможно или неудобно получать непосредственно при работе со стандартными визуальными представлениями журналов, справочников или перечислений.

Одним из примеров использования данного объекта может служить организация выбора конкретного товара из таблицы возможных товаров, сформированной по сложному алгоритму.

При работе с таблицей значений следует различать два понятия текущей строки таблицы. Во-первых, существует текущая строка объекта «ТаблицаЗначений», которая устанавливается при помощи методов ПолучитьСтрокуПоНомеру, ВыбратьСтроки, ПолучитьСтроку, эта текущая строка меняется программно и служит для обращения к значениям колонок с помощью идентификаторов уже без указания строки. Во-вторых, существует текущая строка элемента формы диалога «ТаблицаЗначений», которая является активной строкой (на ней установлен курсор) в диалоге. Текущая строка элемента диалога возвращается и устанавливается исключительно только при помощи метода ТекущаяСтрока. Например, если программно сменить текущую строку объекта, курсор в визуальном представлении диалога сам собой не передвинется, это можно выполнить только при помощи метода ТекущаяСтрока. Однако, при вызове из формы процедуры обработки, текущая строка объекта будет совпадать с текущей строкой визуального представления.

Контекст работы с Таблицей Значений

Во всех программных модулях вызов соответствующих методов может выполняться при помощи переменной со ссылкой на объект типа «ТаблицаЗначений». Такой объект можно создавать при помощи функции СоздатьОбъект ссылка на который присваивается переменной. Кроме того, если в форму диалога при помощи визуальных средств конфигуратора вставлен специальный элемент формы диалога «ТаблицаЗначений», то идентификатор этого элемента доступен в контексте программного модуля этой формы как уже существующий объект типа «ТаблицаЗначений».

Чтобы вызвать метод объекта, имя метода (с указанием необходимых параметров) пишется через точку после имени объекта.

При создании объекта типа «ТаблицаЗначений» при помощи функции СоздатьОбъект, в качестве названия агрегатного типа данных обязательно должно выступать ключевое слово ТаблицаЗначений.

Англоязычный синоним ключевого слова ТаблицаЗначений — ValueTable.

Пример:

МояТаблицаЗначений = СоздатьОбъект("ТаблицаЗначений");

Атрибуты Таблицы Значений

НомерСтроки

Номер текущей строки таблицы.

Синтаксис:

НомерСтроки

Англоязычный синоним:

LineNo

Описание;

Атрибут (только для чтения) НомерСтроки содержит номер текущей строки таблицы значений.

<ИдентификаторКолонки>

Значение элемента таблицы в текущей строке в колонке, заданной идентификатором.

Синтаксис:

<ИдетификаторКолонки>

Описание:

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

Методы объекта Таблица Значений

КоличествоКолонок

Устанавливает/возвращает количество колонок.

Синтаксис:

КоличествоКолонок(<КоличКолонок>)

Англоязычный синоним:

ColumnCount

Параметры:

Возвращаемое значение: количество колонок до вызова метода.

Описание:

Метод КоличествоКолонок устанавливает/возвращает количество колонок таблицы значений.

Пример:

Разм = ТаблицаТоваров.КоличествоКолонок();

НоваяКолонка

Добавить в конец таблицы значений новую колонку.

Синтаксис:

НоваяКолонка(<Идентификатор>, <Тип>, <Длина>, <Точность>, <3аголовок>, <Ширина>,

              <Формат>, <Положение>)

Англоязычный синоним:

NewColumn

Параметры:

Возвращаемое значение: номер новой колонки.

Описание:

Метод НоваяКолонка добавляет в конец таблицы значений новую колонку,

Пример:

Табл.НоваяКолонка("Код", "Число", 6, 0, "Код", 6);

ВставитьКолонку

Вставить новую колонку в таблицу значений в указанную позицию.

Синтаксис:

ВставитьКолонку(<Идентификатор>, <НомерКолонки>, <Тип>, <Длина>, <Точность>,

                <3аголовок>, <Ширина>, <Формат>, <Положение>)

Англоязычный синоним:

InsertColumn

Параметры:

Возвращаемое значение: номер новой колонки.

Описание:

Метод ВставитьКолонку вставляет новую колонку в таблицу значений в указанную позицию.

Пример:

Табл.ВставитьКолонку("Код", 1, "Число", 6, 0, "Код", 6);

УдалитьКолонку

Удаляет колонку из таблицы значений.

Синтаксис:

УдалитьКолонку(<Колонка>)

Англоязычный синоним:

DeleteColumn

Параметры:

Описание:

Метод УдалитьКолонку удаляет колонку <Колонка> из таблицы значений.

Пример:

ТаблДокументов.УдалитьКолонку(2);

УстановитьПараметрыКолонки

Устанавливает новые значения параметров колонки.

Синтаксис:

УстановитьПараметрыКолонки(<Колонка>, <Тип>, <Длина>, <Точность>, <3аголовок>,

                           <Ширина>, <Формат>, <Положение>)

Англоязычный синоним:

SetColumnParameters

Параметры:

Описание:

Метод УстановитьПараметрыКолонки устанавливает новые значения параметров колонки (только те которые указаны). Если какой либо параметр при вызове метода не задан, то данный параметр колонки не изменяется.

Пример:

Табл.УстановитьПараметрыКолонки("Код", "Число", 6, 0, "Код", 6);

ПолучитьПараметрыКолонки

Возвращает значения параметров колонки.

Синтаксис:

ПолучитьПараметрыКолонки(<Колонка>, <Тип>, <Длина>, <Точность>, <3аголовок>,

                         <Ширина>, <Формат>, <Положение>)

Англоязычный синоним:

GetColumnParameters

Параметры:

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

Номер или идентификатор колонки. Если в параметре <Колонка> задан номер колонки, то возвращается идентификатор колонки, и наоборот.

Описание:

Метод ПолучитьПараметрыКолонки возвращает значения параметров колонки по номеру колонки или по ее идентификатору.

Пример:

Перем ВыбТип;

Перем ВыбДлина;

Перем ВыбТочность;

Перем ВыбЗаголовок;

Перем ВыбШирина;

Табл.ПолучитьПараметрыКолонки("Код", ВыбТип, ВыбДлина, ВыбТочность, ВыбЗаголовок,

                                ВыбШирина);

КоличествоСтрок

Устанавливает/возвращает количество строк в таблице значений,

Синтаксис:

КоличествоСтрок(<НовоеКоличествоСтрок>)

Англоязычный синоним:

LinesCnt

Параметры:

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

Числовое значение — количество строк в таблице значений до вызова метода.

Описание:

Метод КоличествоСтрок устанавливает/возвращает количество строк в таблице значений

Пример:

Разм = ТаблицаТоваров.КоличествоСтрок();

НоваяСтрока

Добавляет новую строку в таблицу значений.

Синтаксис:

НоваяСтрока(<НомерСтроки>)

Англоязычный синоним:

NewLine

Параметры:

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

Возвращаемое значение: номер новой строки.

Описание:

Метод НоваяСтрока вставляет новую строку в таблицу значений в указанную позицию.

Пример:

Табл.НоваяСтрока(1);

УдалитьСтроку

Удаляет строку из таблицы значений.

Синтаксис:

УдалитьСтроку(<НомерСтроки>)

Англоязычный синоним:

DeleteLine

Параметры:

Описание:

Метод УдалитьСтроку удаляет строку из таблицы значений.

Пример:

ТаблДокументов.УдалитьСтроку(2);

УдалитьСтроки

Удаляет все строки из таблицы значений.

Синтаксис:

УдалитьСтроки()

Англоязычный синоним:

DeleteLines

Описание:

Метод УдалитьСтроки удаляет все строки из таблицы значений.

Пример:

ТаблДокументов.УдалитьСтроки();

ВыбратьСтроки

Открывает выборку строк таблицы значений.

Синтаксис:

ВыбратьСтроки()

Англоязычный синоним:

SelectLines

Описание:

Метод ВыбратьСтроки предоставляет возможность перебирать строки таблицы значений (открывает выборку). Дальнейшая выборка осуществляется при помощи метода ПолучитьСтроку.

Пример:

Табл.ВыбратьСтроки();

Пока Табл.ПолучитьСтроку() = 1 Цикл

   ...

КонецЦикла;

ПолучитьСтроку

Получить из выборки следующую строку таблицы значений.

Синтаксис:

ПолучитьСтроку()

Англоязычный синоним:

GetLine

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

Число: 1 — если строка выбрана успешно, 0 — если строка не выбрана (выборка закончилась).

Описание:

Метод ПолучитьСтроку выбирает следующую строку таблицы значений в последовательности выборки, открытой перед этим при помощи метода ВыбратьСтроки.

Пример:

Табл.ВыбратьСтроки();

Пока Табл.ПолучитьСтроку() = 1 Цикл

   ...

КонецЦикла;

ВыбратьСтроку

Открыть окно для интерактивного выбора строки в таблице значений.

Синтаксис:

ВыбратьСтроку(<Строка>, <3аголовок>, < Таймаут>)

Англоязычный синоним:

ChooseLine

Параметры:

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

Числовое значение: 1 — если выбор произведен (нажата кнопка «ОК»); 0 — если выбор не произведен (нажата кнопка «ОТМЕНА»); -1 (минус единица) — закончилось время <Таймаут> ожидания отклика пользователя.

Описание:

Метод ВыбратьСтроку вызывает диалоговое окно для интерактивного выбора строки из заранее подготовленной таблицы значений. Параметр <Строка> указывает на ту строку таблицы значений, на которой будет установлен курсор при открытии окна выбора. В этот же параметр возвращается выбранное значение. Если выбор отменен, то значение параметров не меняются.

Пример:

Перем НомСтроки;

Табл.ВыбратьСтроку(НомСтроки, "Выберите строку");

ПолучитьСтрокуПоНомеру

Получить строку таблицы значений по номеру.

Синтаксис:

ПолучитьСтрокуПоНомеру(<НомерСтроки>)

Англоязычный синоним:

GetLineByNumber

Параметры:

Описание:

Метод ПолучитьСтрокуПоНомеру получает строку таблицы значений по заданному номеру. Указанная строка становится текущей.

Пример:

Табл.ПолучитьСтрокуПоНомеру(3);

СдвинутьСтроку

Переместить строку таблицы значений на новую позицию.

Синтаксис:

СдвинутьСтроку(<КоличествоСтрок>, <НомерСтроки>)

Англоязычный синоним:

MoveLine

Параметры:

Возвращаемое значение: новая позиция строки

Описание:

Метод СдвинутьСтроку перемещает строку таблицы значений на новую позицию.

Пример:

Табл.СдвинутьСтроку(3, 5);

УстановитьЗначение

Установить значение конкретной колонки в данной строке таблицы значений.

Синтаксис:

УстановитьЗначение(<Строка>, <Колонка>, <Знач>)

Англоязычный синоним:

SetValue

Параметры:

Описание:

Метод УстановитьЗначение устанавливает значение конкретной колонки в данной строке таблицы значений.

Пример:

Табл.УстановитьЗначение(3, 5, ВыбЗнач);

ПолучитьЗначение

Получить значение конкретной колонки в данной строке таблицы значений.

Синтаксис:

ПолучитьЗначение(<Строка>, <Колонка>)

Англоязычный синоним:

GetValue

Параметры:

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

Значение конкретной колонки в данной строке.

Описание:

Метод ПолучитьЗначение получает значение конкретной колонки в данной строке таблицы значений.

Пример:

ВыбЗнач = Табл.ПолучитьЗначение(3, 5);

НайтиЗначение

Найти заданное значение в таблице значений.

Синтаксис:

НайтиЗначение(<Знач>, <Строка>, <Колонка>)

Англоязычный синоним:

FindValue

Параметры:

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

Число: 0 — значение не найдено; 1 — значение найдено.

Описание:

Метод НайтиЗначение позволяет найти искомое значение в таблице значений и определить номер строки и номер колонки таблицы значений.

Пример:

Перем НомСтр;

Перем НомКолонки;

Табл.НайтиЗначение(ВыбЗнач, НомСтр, НомКолонки);

Сортировать

Сортировать таблицу значений по колонкам.

Синтаксис:

Сортировать(<Колонки>, <ДокументыПоДате>)

Англоязычный синоним:

Sort

Параметры:

Описание:

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

Пример:

Табл.Сортировать("-Код, +Цена, -8, 5");

Очистить

Очистить таблицу значений и удалить колонки.

Синтаксис:

Очистить()

Англоязычный синоним:

Clear

Описание:

Метод Очистить выполняет очистку таблицы значений и удаляет колонки.

Пример:

Табл.Очистить();

Итог

Вычислить сумму по колонке таблицы значений.

Синтаксис:

Итог(<Колонка>)

Англоязычный синоним:

Total

Параметры:

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

Сумма по колонке.

Описание:

Метод Итог вычисляет сумму по заданной колонке таблицы значений.

Пример:

Табл.Итог(2);

Заполнить

Заполнить значения конкретных колонок в строках таблицы значений переданным значением.

Синтаксис:

Заполнить(<Знач>, <НачСтрока>, <КонСтрока>, <Колонки>)

Англоязычный синоним:

Fill

Параметры:

Описание:

Метод Заполнить позволяет заполнить значения конкретных колонок в строках таблицы значений переданным значением.

Пример:

Табл.Заполнить(ВыбЗнач, 2, 5, "5, 6, 7");

Свернуть

Свернуть таблицу значений но соответствующим значениям колонок.

Синтаксис:

Свернуть(<ГруппКолонки>, <СуммКолонки>)

Англоязычный синоним:

GroupBy

Параметры:

Описание:

Метод Свернуть позволяет свернуть таблицу значений по соответствующим значениям колонок, т. е. заменяет на одну строку все дублирующие (по значениям группировочных колонок) строки, суммируя значения но суммируемым колонкам.

Пример:

Табл.Свернуть("1,2,3,4", "5,6,7");

Выгрузить

Выгрузить данные из таблицы значений.

Синтаксис:

Выгрузить(<Знач>, <НачСтрока>, <КонСтрока>, <Колонки>)

Англоязычный синоним:

Unload

Параметры:

Описание:

Метод Выгрузить позволяет выгрузить заданную область таблицы значений в переданное значение. Если в качестве значения для выгрузки задан список значений, то система выгружает данные из таблицы значений по колонкам.

Пример:

НовТабл = СоздатьОбъект("ТаблицаЗначений");

СтарТабл.Выгрузить(НовТабл, 1, 5, "1,3,5,7");

Загрузить

Скопировать структуру и значения таблицы значений.

Синтаксис:

Загрузить(<ТаблицаЗначений>)

Англоязычный синоним:

Load

Параметры:

Описание:

Метод Загрузить позволяет скопировать структуру и значения таблицы значений. Прежняя структура колонок таблицы значений при этом очищается.

Пример:

НовТабл = СоздатьОбъект("ТаблицаЗначений");

НовТабл.Загрузить(СтарТабл);

ВидимостьКолонки

Показать/скрыть колонки таблицы значений.

Синтаксис:

ВидимостьКолонки(<Колонки>, <Видимость>, <Позиция>)

Англоязычный синоним:

ColumnVisibility

Параметры:

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

Если передана одна колонка, то возвращается значение видимости колонки до вызова метода. Число: 1 — колонка показана; 0 — колонка скрыта.

Описание:

Метод ВидимостьКолонки определяет перечень колонок и их видимость в визуальном представлении таблицы значений.

Пример:

ТаблДиалога.ВидимостьКолонки("Код, Цена, 8, 5");

ТекущаяСтрока

Установить/определить текущую строку таблицы в элементе диалога типа «ТаблицаЗначений».

Синтаксис:

ТекущаяСтрока(<ИндексСтроки>)

Англоязычный синоним:

CurrentLine

Параметры:

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

Числовое значение, соответствующее индексу текущей строки поля диалога (до его изменения) или 0, если текущей строки нет.

Описание:

Метод ТекущаяСтрока в тексте программного модуля можно использовать синтаксически как функцию или процедуру. Данный метод позволяет установить и/или считать текущее положение курсора в элементе диалога типа «ТаблицаЗначений».

Данный метод можно использовать только для объектов, которые созданы при помощи визуальных средств конфигуратора (в форму вставлены элементы диалога «ТаблицаЗначений», а идентификаторы этих элементов доступны в контексте программного модуля этой формы как уже существующие объекты типа «ТаблицаЗначений»).

Пример:

ТаблДиалога.ТекущаяСтрока(2);

ТекущаяКолонка

Установить/определить текущую колонку таблицы в элементе диалога типа «ТаблицаЗначений».

Синтаксис:

ТекущаяКолонка(<НоваяКолонка>, <ТекущаяКолонка>)

Англоязычный синоним:

CurrentColumn

Параметры:

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

Идентификатор текущей колонки поля диалога (до его изменения) или "" (пустая строка), если ее нет.

Описание:

Метод ТекущаяКолонка в тексте программного модуля можно использовать синтаксически как функцию или процедуру. Данный метод позволяет установить и/или считать текущее положение курсора в элементе диалога типа «ТаблицаЗначений».

Данный метод можно использовать только для объектов, которые созданы при помощи визуальных средств конфигуратора (в форму вставлены элементы диалога «ТаблицаЗначений», а идентификаторы этих элементов доступны в контексте программного модуля этой формы как уже существующие объекты типа «ТаблицаЗначений»).

Пример:

Перем НомКолонки;

ТаблДиалога.ТекущаяКолонка(2, НомКолонки);

Фиксировать

Фиксировать в элементе диалога типа «ТаблицаЗначений» колонки и строки.

Синтаксис:

Фиксировать(<КолСтрок>, <КолКолонок>)

Англоязычный синоним:

Fix

Параметры:

Описание:

Метод Фиксировать позволяет фиксировать в элементе диалога типа «ТаблицаЗначений» колонки и строки.

Пример:

ТаблДиалога.Фиксировать(1, 1);

ВыводитьПиктограммы

Выводить в элементе диалога типа «ТаблицаЗначений» пиктограммы.

Синтаксис:

ВыводитьПиктограммы(<Колонка>, <Пиктограмма>)

Англоязычный синоним:

Showlmages

Параметры:

Описание:

Метод ВыводитьПиктограммы устанавливает режим, при котором в колонке выводится не текст, а пиктограмма. Пиктограмма будет браться из картинки, назначенной элементу диалога «ТаблицаЗначений» в закладке «Картинка» в конфигураторе. Картинка должна быть формата .bmp, содержать все пиктограммы для этой таблицы значений, и состоять из последовательности пиктограмм размером 16х15 пикселей. Пиктограммы будут выбираться из картинки по номеру, взятому из числового значения данной колонки в текущей строке. Параметр <Пиктограмма> позволяет установить для данной колонки начальный номер пиктограмм в картинке.

Пример:

ТаблДиалога.ВыводитьПиктограммы(1, 1);

Пример использования объекта Таблица Значений

Пример:

Функция ВыбратьОплаты(ВыбДок)

   ТЗ = СоздатьОбъект("ТаблицаЗначений");

   ТЗ.НоваяКолонка("ДатаДок", "Дата", , , "Дата", 15);

   ТЗ.НоваяКолонка("Номер", "Строка", 20, , "Номер", 15);

   ТЗ.НоваяКолонка("Сумма", "Число", 18, 2, "Сумма", 20);

   ТЗ.НоваяКолонка("РасчетныйСчет", "Справочник.БанковскиеСчета", , ,

                   "Расч.счет", 30);

   ТЗ.НоваяКолонка("ПодчДок", "Документ", , , );

   ТЗ.ВидимостьКолонки("ПодчДок", 0);

   Док = СоздатьОбъект("Документ");

   Док.ВыбратьПодчиненныеДокументы(, , ВыбДок);

   Пока Док.ПолучитьДокумент() = 1 Цикл

      Если Док.Вид() = "ОплатаПоставщикам" Тогда

         ТЗ.НоваяСтрока();

         ТЗ.ДатаДок = Док.ДатаДок;

         ТЗ.Номер = Док.НомерДок;

         ТЗ.Сумма = Док.Итог("Сумма");

         ТЗ.РасчетныйСчет = Док.РасчетныйСчет;

         ТЗ.ПодчДок = Док.ТекущийДокумент();

      КонецЕсли;

   КонецЦикла;

   ВыбСтрока = 0;

   Если ТЗ.ВыбратьСтроку(ВыбСтрока, "Выберите оплату") = 1 Тогда

      Возврат ТЗ.ПолучитьЗначение(ВыбСтрока, "ПодчДок");

КонецФункции

---

---