Объект типа «ТаблицаЗначений» ~ это средство языка (не сохраняемый в информационной базе объект), которое позволяет строить «динамические массивы» и манипулировать ими (добавлять, редактировать, удалять элементы, сортировать). Таблица значений может быть наполнена значениями любого типа, т. е. в одной таблице типы хранимых значений могут быть разными. Таблица значений может использоваться и как простой двумерный массив (матрица) значений и как таблица строк определенной структуры, когда колонки типизованы и имеют идентификаторы.
Специальный элемент формы диалога «ТаблицаЗначений» является интерфейсным средством отображения и манипулирования этим объектом в формах диалогов. При формировании пользовательского интерфейса прикладной задачи довольно часто возникают ситуации, когда для удобства работы пользователя необходимо дать ему возможность выбирать какое-либо значение из заранее подготовленной таблицы значений. Возможности работы со справочниками, журналами и перечислениями предоставляют достаточно мощные средства выбора этих объектов. Однако, существует также необходимость в выборе значений из таблиц, сформированных и отсортированных нестандартным образом, которые невозможно или неудобно получать непосредственно при работе со стандартными визуальными представлениями журналов, справочников или перечислений.
Одним из примеров использования данного объекта может служить организация выбора конкретного товара из таблицы возможных товаров, сформированной по сложному алгоритму.
При работе с таблицей значений следует различать два понятия текущей строки таблицы. Во-первых, существует текущая строка объекта «ТаблицаЗначений», которая устанавливается при помощи методов ПолучитьСтрокуПоНомеру, ВыбратьСтроки, ПолучитьСтроку, эта текущая строка меняется программно и служит для обращения к значениям колонок с помощью идентификаторов уже без указания строки. Во-вторых, существует текущая строка элемента формы диалога «ТаблицаЗначений», которая является активной строкой (на ней установлен курсор) в диалоге. Текущая строка элемента диалога возвращается и устанавливается исключительно только при помощи метода ТекущаяСтрока. Например, если программно сменить текущую строку объекта, курсор в визуальном представлении диалога сам собой не передвинется, это можно выполнить только при помощи метода ТекущаяСтрока. Однако, при вызове из формы процедуры обработки, текущая строка объекта будет совпадать с текущей строкой визуального представления.
Во всех программных модулях вызов соответствующих методов может выполняться при помощи переменной со ссылкой на объект типа «ТаблицаЗначений». Такой объект можно создавать при помощи функции СоздатьОбъект ссылка на который присваивается переменной. Кроме того, если в форму диалога при помощи визуальных средств конфигуратора вставлен специальный элемент формы диалога «ТаблицаЗначений», то идентификатор этого элемента доступен в контексте программного модуля этой формы как уже существующий объект типа «ТаблицаЗначений».
Чтобы вызвать метод объекта, имя метода (с указанием необходимых параметров) пишется через точку после имени объекта.
При создании объекта типа «ТаблицаЗначений» при помощи функции СоздатьОбъект, в качестве названия агрегатного типа данных обязательно должно выступать ключевое слово ТаблицаЗначений.
Англоязычный синоним ключевого слова ТаблицаЗначений — ValueTable.
Пример:
МояТаблицаЗначений = СоздатьОбъект("ТаблицаЗначений");
Номер текущей строки таблицы.
Синтаксис:
НомерСтроки
Англоязычный синоним:
LineNo
Описание;
Атрибут (только для чтения) НомерСтроки содержит номер текущей строки таблицы значений.
Значение элемента таблицы в текущей строке в колонке, заданной идентификатором.
Синтаксис:
<ИдетификаторКолонки>
Описание:
Данный атрибут содержит значение таблицы значений в текущей строке в колонке, заданной идентификатором. В тексте программного модуля используется идентификатор конкретной колонки, который задается при создании колонки при помощи методов ДобавитьКолонку и ВставитьКолонку. Если при создании колонки идентификатор колонки не указан, то обращение к колонке возможно только по номеру.
Устанавливает/возвращает количество колонок.
Синтаксис:
КоличествоКолонок(<КоличКолонок>)
Англоязычный синоним:
ColumnCount
Параметры:
|
<КоличКолонок> |
Необязательный параметр. Числовое выражение, которое указывает новое количество колонок. Если параметр опущен, то количество колонок не меняется. |
Возвращаемое значение: количество колонок до вызова метода.
Описание:
Метод КоличествоКолонок устанавливает/возвращает количество колонок таблицы значений.
Пример:
Разм = ТаблицаТоваров.КоличествоКолонок();
Добавить в конец таблицы значений новую колонку.
Синтаксис:
НоваяКолонка(<Идентификатор>, <Тип>, <Длина>, <Точность>, <3аголовок>, <Ширина>,
<Формат>, <Положение>)
Англоязычный синоним:
NewColumn
Параметры:
|
<Идентификатор> |
Необязательный параметр. Идентификатор колонки, если не указан обращение к колонке возможно только по номеру. |
|
<Тип> |
Необязательный параметр. Строка или вид субкон-то, задающий тип колонки. Если не указан, то можно хранить любой тип. |
|
<Длина> |
Необязательный параметр. Длина для числовой или строковой колонки. |
|
<Точность> |
Необязательный параметр. Точность (длина дробной части) для числовой колонки. |
|
<3аголовок> |
Необязательный параметр. Строковое выражение содержащее заголовок колонки в элементе диалога типа «ТаблицаЗначений». |
|
<Ширина> |
Необязательный параметр. Числовое выражение, содержащее ширину колонки (в символах) для представления колонки в элементе диалога типа «ТаблицаЗначений». |
|
<Формат> |
Необязательный параметр. Строковое выражение, содержащее форматную строку, которая будет использована при визуальном отображении значений данной колонки. |
|
<Положение> |
Необязательный параметр. Определяет вариант выравнивания при визуальном отображении значений данной колонки. Число: 1 — слева; 2 — справа. |
Возвращаемое значение: номер новой колонки.
Описание:
Метод НоваяКолонка добавляет в конец таблицы значений новую колонку,
Пример:
Табл.НоваяКолонка("Код", "Число", 6, 0, "Код", 6);
Вставить новую колонку в таблицу значений в указанную позицию.
Синтаксис:
ВставитьКолонку(<Идентификатор>, <НомерКолонки>, <Тип>, <Длина>, <Точность>,
<3аголовок>, <Ширина>, <Формат>, <Положение>)
Англоязычный синоним:
InsertColumn
Параметры:
|
<Идентификатор> |
Необязательный параметр. Идентификатор колонки, если не указан обращение к колонке возможно только по номеру. |
|
<НомерКолонки> |
Необязательный параметр. Числовое выражение, содержащее позицию, в которую вставляется новая колонка. |
|
<Тип> |
Необязательный параметр. Строка или вид суб кон-то, задающий тип колонки. Если не указан, то можно хранить любой тип. |
|
<Длина> |
Необязательный параметр. Длина для числовой или строковой колонки. |
|
<Точность> |
Необязательный параметр. Точность (длина дробной части) для числовой колонки. |
|
<Заголовок> |
Необязательный параметр. Строковое выражение, содержащее заголовок колонки в элементе диалога типа «ТаблицаЗначений». |
|
<Ширина> |
Необязательный параметр. Числовое выражение, содержащее ширину колонки (в символах) для представления колонки в элементе диалога типа «ТаблицаЗначений». |
|
<Формат> |
Необязательный параметр. Строковое выражение, содержащее форматную строку, которая будет использована при визуальном отображении значений данной колонки. |
|
<Положение> |
Необязательный параметр. Определяет вариант выравнивания при визуальном отображении значений данной колонки. Число: 1 — слева; 2 — справа. |
Возвращаемое значение: номер новой колонки.
Описание:
Метод ВставитьКолонку вставляет новую колонку в таблицу значений в указанную позицию.
Пример:
Табл.ВставитьКолонку("Код", 1, "Число", 6, 0, "Код", 6);
Удаляет колонку из таблицы значений.
Синтаксис:
УдалитьКолонку(<Колонка>)
Англоязычный синоним:
DeleteColumn
Параметры:
|
<Колонка> |
Номер или идентификатор колонки. |
Описание:
Метод УдалитьКолонку удаляет колонку <Колонка> из таблицы значений.
Пример:
ТаблДокументов.УдалитьКолонку(2);
Устанавливает новые значения параметров колонки.
Синтаксис:
УстановитьПараметрыКолонки(<Колонка>, <Тип>, <Длина>, <Точность>, <3аголовок>,
<Ширина>, <Формат>, <Положение>)
Англоязычный синоним:
SetColumnParameters
Параметры:
|
<Колонка> |
Номер или идентификатор колонки, для которой будут установлены новые параметры. |
|
<Тип> |
Необязательный параметр. Строка, описывающая тип колонки или вид субконто. |
|
<Длина> |
Необязательный параметр. Длина для строковых и числовых значений. |
|
<Точность> |
Необязательный параметр. Точность для числовых значений. |
|
<3аголовок> |
Необязательный параметр. Заголовок колонки для показа. |
|
<Ширина> |
Необязательный параметр. Ширина колонки в таблице. |
|
<Формат> |
Необязательный параметр. Строковое выражение, содержащее форматную строку, которая будет использована при визуальном отображении значений данной колонки. |
|
<Положение> |
Необязательный параметр. Определяет вариант выравнивания при визуальном отображении значений данной колонки. Число: 1 — слева; 2 — справа. |
Описание:
Метод УстановитьПараметрыКолонки устанавливает новые значения параметров колонки (только те которые указаны). Если какой либо параметр при вызове метода не задан, то данный параметр колонки не изменяется.
Пример:
Табл.УстановитьПараметрыКолонки("Код", "Число", 6, 0, "Код", 6);
Возвращает значения параметров колонки.
Синтаксис:
ПолучитьПараметрыКолонки(<Колонка>, <Тип>, <Длина>, <Точность>, <3аголовок>,
<Ширина>, <Формат>, <Положение>)
Англоязычный синоним:
GetColumnParameters
Параметры:
|
<Колонка> |
Номер или идентификатор колонки, для которой требуется получить параметры. |
|
<Тип> |
Необязательный параметр. Идентификатор переменной, в которую метод вернет строку, описывающую тип колонки. |
|
<Длина> |
Необязательный параметр. Идентификатор переменной, в которую метод вернет длину для строковых и числовых значений. |
|
<Точность> |
Необязательный параметр. Идентификатор переменной, в которую метод вернет точность для числовых значений колонки. |
|
<3аголовок> |
Необязательный параметр. Идентификатор переменной, в которую метод вернет строку, описывающую заголовок колонки для показа. |
|
<Ширина> |
Необязательный параметр. Идентификатор переменной, в которую метод вернет ширину колонки в таблице. |
|
<Формат> |
Необязательный параметр. Строковое выражение, содержащее форматную строку, которая будет использована при визуальном отображении значений данной колонки. |
|
<Положение> |
Необязательный параметр. Определяет вариант выравнивания при визуальном отображении значений данной колонки. Число: 1 — слева; 2 — справа. |
Возвращаемое значение:
Номер или идентификатор колонки. Если в параметре <Колонка> задан номер колонки, то возвращается идентификатор колонки, и наоборот.
Описание:
Метод ПолучитьПараметрыКолонки возвращает значения параметров колонки по номеру колонки или по ее идентификатору.
Пример:
Перем ВыбТип;
Перем ВыбДлина;
Перем ВыбТочность;
Перем ВыбЗаголовок;
Перем ВыбШирина;
Табл.ПолучитьПараметрыКолонки("Код", ВыбТип, ВыбДлина, ВыбТочность, ВыбЗаголовок,
ВыбШирина);
Устанавливает/возвращает количество строк в таблице значений,
Синтаксис:
КоличествоСтрок(<НовоеКоличествоСтрок>)
Англоязычный синоним:
LinesCnt
Параметры:
|
<НовоеКоличествоСтрок> |
Необязательный параметр. Новое количество строк в таблице значений. |
Возвращаемое значение:
Числовое значение — количество строк в таблице значений до вызова метода.
Описание:
Метод КоличествоСтрок устанавливает/возвращает количество строк в таблице значений
Пример:
Разм = ТаблицаТоваров.КоличествоСтрок();
Добавляет новую строку в таблицу значений.
Синтаксис:
НоваяСтрока(<НомерСтроки>)
Англоязычный синоним:
NewLine
Параметры:
<НомерСтроки> Необязательный параметр. Числовое выражение, содержащее позицию, в которую следует вставить новую строку.
Возвращаемое значение: номер новой строки.
Описание:
Метод НоваяСтрока вставляет новую строку в таблицу значений в указанную позицию.
Пример:
Табл.НоваяСтрока(1);
Удаляет строку из таблицы значений.
Синтаксис:
УдалитьСтроку(<НомерСтроки>)
Англоязычный синоним:
DeleteLine
Параметры:
|
<НомерСтроки> |
Необязательный параметр. Номер строки. Если не указан, то удаляется текущая строка |
Описание:
Метод УдалитьСтроку удаляет строку из таблицы значений.
Пример:
ТаблДокументов.УдалитьСтроку(2);
Удаляет все строки из таблицы значений.
Синтаксис:
УдалитьСтроки()
Англоязычный синоним:
DeleteLines
Описание:
Метод УдалитьСтроки удаляет все строки из таблицы значений.
Пример:
ТаблДокументов.УдалитьСтроки();
Открывает выборку строк таблицы значений.
Синтаксис:
ВыбратьСтроки()
Англоязычный синоним:
SelectLines
Описание:
Метод ВыбратьСтроки предоставляет возможность перебирать строки таблицы значений (открывает выборку). Дальнейшая выборка осуществляется при помощи метода ПолучитьСтроку.
Пример:
Табл.ВыбратьСтроки();
Пока Табл.ПолучитьСтроку() = 1 Цикл
...
КонецЦикла;
Получить из выборки следующую строку таблицы значений.
Синтаксис:
ПолучитьСтроку()
Англоязычный синоним:
GetLine
Возвращаемое значение:
Число: 1 — если строка выбрана успешно, 0 — если строка не выбрана (выборка закончилась).
Описание:
Метод ПолучитьСтроку выбирает следующую строку таблицы значений в последовательности выборки, открытой перед этим при помощи метода ВыбратьСтроки.
Пример:
Табл.ВыбратьСтроки();
Пока Табл.ПолучитьСтроку() = 1 Цикл
...
КонецЦикла;
Открыть окно для интерактивного выбора строки в таблице значений.
Синтаксис:
ВыбратьСтроку(<Строка>, <3аголовок>, < Таймаут>)
Англоязычный синоним:
ChooseLine
Параметры:
|
<Строка> |
Необязательный параметр. Идентификатор переменной, куда помещается значение — номер выбранной строки. При вызове метода здесь можно передавать значение начального номера строки. |
|
<3аголовок> |
Необязательный параметр. Строковое выражение, значение которого отображается в заголовке диалогового окна. Может использоваться для подсказки пользователю. |
|
<Таймаут> |
Необязательный параметр. Числовое выражение, значение которого задает время ожидания системы (в секундах) на отклик пользователя. Если не задано, то время ожидания бесконечно. |
Возвращаемое значение:
Числовое значение: 1 — если выбор произведен (нажата кнопка «ОК»); 0 — если выбор не произведен (нажата кнопка «ОТМЕНА»); -1 (минус единица) — закончилось время <Таймаут> ожидания отклика пользователя.
Описание:
Метод ВыбратьСтроку вызывает диалоговое окно для интерактивного выбора строки из заранее подготовленной таблицы значений. Параметр <Строка> указывает на ту строку таблицы значений, на которой будет установлен курсор при открытии окна выбора. В этот же параметр возвращается выбранное значение. Если выбор отменен, то значение параметров не меняются.
Пример:
Перем НомСтроки;
Табл.ВыбратьСтроку(НомСтроки, "Выберите строку");
Получить строку таблицы значений по номеру.
Синтаксис:
ПолучитьСтрокуПоНомеру(<НомерСтроки>)
Англоязычный синоним:
GetLineByNumber
Параметры:
|
<НомерСтроки> |
Номер строки, на которую следует переместиться. |
Описание:
Метод ПолучитьСтрокуПоНомеру получает строку таблицы значений по заданному номеру. Указанная строка становится текущей.
Пример:
Табл.ПолучитьСтрокуПоНомеру(3);
Переместить строку таблицы значений на новую позицию.
Синтаксис:
СдвинутьСтроку(<КоличествоСтрок>, <НомерСтроки>)
Англоязычный синоним:
MoveLine
Параметры:
|
<КоличествоСтрок> |
Число строк, на которое надо переместить строку. Если число положительное, то строка сдвигается вниз, если отрицательное, то вверх. |
|
<НомерСтроки> |
Необязательный параметр. Номер строки, которую надо переместить, если не задан, то текущая. |
Возвращаемое значение: новая позиция строки
Описание:
Метод СдвинутьСтроку перемещает строку таблицы значений на новую позицию.
Пример:
Табл.СдвинутьСтроку(3, 5);
Установить значение конкретной колонки в данной строке таблицы значений.
Синтаксис:
УстановитьЗначение(<Строка>, <Колонка>, <Знач>)
Англоязычный синоним:
SetValue
Параметры:
|
<Строка> |
Номер строки. |
|
<Колонка> |
Номер или идентификатор колонки. |
|
<Знач> |
Устанавливаемое значение. |
Описание:
Метод УстановитьЗначение устанавливает значение конкретной колонки в данной строке таблицы значений.
Пример:
Табл.УстановитьЗначение(3, 5, ВыбЗнач);
Получить значение конкретной колонки в данной строке таблицы значений.
Синтаксис:
ПолучитьЗначение(<Строка>, <Колонка>)
Англоязычный синоним:
GetValue
Параметры:
|
<Строка> |
Номер строки. |
|
<Колонка> |
Номер или идентификатор колонки. |
Возвращаемое значение:
Значение конкретной колонки в данной строке.
Описание:
Метод ПолучитьЗначение получает значение конкретной колонки в данной строке таблицы значений.
Пример:
ВыбЗнач = Табл.ПолучитьЗначение(3, 5);
Найти заданное значение в таблице значений.
Синтаксис:
НайтиЗначение(<Знач>, <Строка>, <Колонка>)
Англоязычный синоним:
FindValue
Параметры:
|
<Знач> |
Значение для поиска. |
|
<Строка> |
Идентификатор переменной, куда возвращается номер найденной строки. Если при вызове метода передать в этот параметр номер строки, то поиск будет осуществляться только по указанной строке. |
|
<Колонка> |
Идентификатор переменной, куда возвращается номер найденной колонки. Если при вызове метода передать в этот параметр номер или идентификатор колонки, то поиск будет осуществляться только по указанной колонке. |
Возвращаемое значение:
Число: 0 — значение не найдено; 1 — значение найдено.
Описание:
Метод НайтиЗначение позволяет найти искомое значение в таблице значений и определить номер строки и номер колонки таблицы значений.
Пример:
Перем НомСтр;
Перем НомКолонки;
Табл.НайтиЗначение(ВыбЗнач, НомСтр, НомКолонки);
Сортировать таблицу значений по колонкам.
Синтаксис:
Сортировать(<Колонки>, <ДокументыПоДате>)
Англоязычный синоним:
Sort
Параметры:
|
<Колонки> |
Строковое выражение, которое определяет колонки, порядок и направление сортировки. Формат передаваемой строки — это разделенные запятыми номера или идентификаторы колонок со знаком направления сортировки ("+" по возрастанию, "-" по убыванию, "*" по внутреннему значению). Знак направления сортировки следует указывать до обозначения колонки через пробел или без пробела. По умолчанию направление сортировки принимается по возрастанию. Например: "-Код, +Цена, -8, 5". |
|
<ДокументыПоДате> |
Необязательный параметр. Имеет смысл только в том случае, если значениями таблицы значений являются документы. В этом случае можно задавать сортировку документов по их хронологии. Число: 1 — сортировка по хронологии документов; 0 — нет. Значение по умолчанию — 0. |
Описание:
Метод Сортировать выполняет сортировку таблицы значений по заданным колонкам, порядку и направлению сортировки.
Пример:
Табл.Сортировать("-Код, +Цена, -8, 5");
Очистить таблицу значений и удалить колонки.
Синтаксис:
Очистить()
Англоязычный синоним:
Clear
Описание:
Метод Очистить выполняет очистку таблицы значений и удаляет колонки.
Пример:
Табл.Очистить();
Вычислить сумму по колонке таблицы значений.
Синтаксис:
Итог(<Колонка>)
Англоязычный синоним:
Total
Параметры:
|
<Колонка> |
Номер или идентификатор колонки, по которой считать сумму. |
Возвращаемое значение:
Сумма по колонке.
Описание:
Метод Итог вычисляет сумму по заданной колонке таблицы значений.
Пример:
Табл.Итог(2);
Заполнить значения конкретных колонок в строках таблицы значений переданным значением.
Синтаксис:
Заполнить(<Знач>, <НачСтрока>, <КонСтрока>, <Колонки>)
Англоязычный синоним:
Fill
Параметры:
|
<Знач> |
Одиночное значение или список значений или таблица значений. |
|
<НачСтрока> |
Необязательный параметр. Номер начальной строки, с которой надо начинать заполнение. Значение по умолчанию 1. |
|
<КонСтрока> |
Необязательный параметр. Номер последней строки, по которую надо заполнять, если не указана то до последней. |
|
<Колонки> |
Необязательный параметр. Номера или идентификаторы колонок, которые надо заполнять. Если параметр не задан, то заполняются все колонки. |
Описание:
Метод Заполнить позволяет заполнить значения конкретных колонок в строках таблицы значений переданным значением.
Пример:
Табл.Заполнить(ВыбЗнач, 2, 5, "5, 6, 7");
Свернуть таблицу значений но соответствующим значениям колонок.
Синтаксис:
Свернуть(<ГруппКолонки>, <СуммКолонки>)
Англоязычный синоним:
GroupBy
Параметры:
|
<ГруппКолонки> |
Группировочные колонки (номера или идентификаторы колонок через запятую), по которым группировать данные. |
|
<СуммКолонки> |
Суммируемые колонки (номера или идентификаторы колонок через запятую), по которым суммировать данные. |
Описание:
Метод Свернуть позволяет свернуть таблицу значений по соответствующим значениям колонок, т. е. заменяет на одну строку все дублирующие (по значениям группировочных колонок) строки, суммируя значения но суммируемым колонкам.
Пример:
Табл.Свернуть("1,2,3,4", "5,6,7");
Выгрузить данные из таблицы значений.
Синтаксис:
Выгрузить(<Знач>, <НачСтрока>, <КонСтрока>, <Колонки>)
Англоязычный синоним:
Unload
Параметры:
|
<Знач> |
Идентификатор переменной, содержащей значение типа «Таблица значений» или «Список значений», в которое нужно выгрузить данные. Если переданное значение пустое, тогда система сама создаст объект типа «Таблица значений». |
|
<НачСтрока> |
Необязательный параметр. Номер начальной строки, с которой надо начинать выгрузку. Значение по умолчанию 1. |
|
<КонСтрока> |
Необязательный параметр. Номер последней строки, по которую надо выгружать, если не указана, то до последней. |
|
<Колонки> |
Необязательный параметр. Номера или идентификаторы колонок, которые надо выгружать. Если параметр не задан, то выгружаются все колонки. |
Описание:
Метод Выгрузить позволяет выгрузить заданную область таблицы значений в переданное значение. Если в качестве значения для выгрузки задан список значений, то система выгружает данные из таблицы значений по колонкам.
Пример:
НовТабл = СоздатьОбъект("ТаблицаЗначений");
СтарТабл.Выгрузить(НовТабл, 1, 5, "1,3,5,7");
Скопировать структуру и значения таблицы значений.
Синтаксис:
Загрузить(<ТаблицаЗначений>)
Англоязычный синоним:
Load
Параметры:
|
<ТаблицаЗначений> |
Значение типа «Таблица значений». Структура и значения для загрузки. |
Описание:
Метод Загрузить позволяет скопировать структуру и значения таблицы значений. Прежняя структура колонок таблицы значений при этом очищается.
Пример:
НовТабл = СоздатьОбъект("ТаблицаЗначений");
НовТабл.Загрузить(СтарТабл);
Показать/скрыть колонки таблицы значений.
Синтаксис:
ВидимостьКолонки(<Колонки>, <Видимость>, <Позиция>)
Англоязычный синоним:
ColumnVisibility
Параметры:
|
<Колонки> |
Строковое выражение, которое определяет список колонок. Формат передаваемой строки — это разделенные запятыми номера или идентификаторы колонок, для которых применяется данный метод. Например: «Код, Цена, 8, 5». |
|
<Видимость> |
Необязательный параметр. Число: 1 — показать колонки; 0 — скрыть. По умолчанию — 1. |
|
<Пoзиция> |
Необязательный параметр. Позиция, в которой показывать колонку. Если параметр не задан, то колонки отображаются в соответствии с порядком колонок в таблице. |
Возвращаемое значение:
Если передана одна колонка, то возвращается значение видимости колонки до вызова метода. Число: 1 — колонка показана; 0 — колонка скрыта.
Описание:
Метод ВидимостьКолонки определяет перечень колонок и их видимость в визуальном представлении таблицы значений.
Пример:
ТаблДиалога.ВидимостьКолонки("Код, Цена, 8, 5");
Установить/определить текущую строку таблицы в элементе диалога типа «ТаблицаЗначений».
Синтаксис:
ТекущаяСтрока(<ИндексСтроки>)
Англоязычный синоним:
CurrentLine
Параметры:
|
<ИндексСтроки> |
Необязательный параметр. Числовое выражение с задаваемым индексом строки для элемента диалога типа «ТаблицаЗначений», на которую требуется установить курсор. Если параметр не задан, то положение курсора в поле диалога не меняется. |
Возвращаемое значение:
Числовое значение, соответствующее индексу текущей строки поля диалога (до его изменения) или 0, если текущей строки нет.
Описание:
Метод ТекущаяСтрока в тексте программного модуля можно использовать синтаксически как функцию или процедуру. Данный метод позволяет установить и/или считать текущее положение курсора в элементе диалога типа «ТаблицаЗначений».
Данный метод можно использовать только для объектов, которые созданы при помощи визуальных средств конфигуратора (в форму вставлены элементы диалога «ТаблицаЗначений», а идентификаторы этих элементов доступны в контексте программного модуля этой формы как уже существующие объекты типа «ТаблицаЗначений»).
Пример:
ТаблДиалога.ТекущаяСтрока(2);
Установить/определить текущую колонку таблицы в элементе диалога типа «ТаблицаЗначений».
Синтаксис:
ТекущаяКолонка(<НоваяКолонка>, <ТекущаяКолонка>)
Англоязычный синоним:
CurrentColumn
Параметры:
|
<НоваяКолонка> |
Необязательный параметр. Номер или идентификатор колонки для элемента диалога типа «ТаблицаЗначений», на которую требуется установить курсор. Если параметр не задан, то текущая колонка в поле диалога не меняется. |
|
<ТекущаяКолонка> |
Необязательный параметр. Идентификатор переменной, куда система возвращает номер текущей колонки. |
Возвращаемое значение:
Идентификатор текущей колонки поля диалога (до его изменения) или "" (пустая строка), если ее нет.
Описание:
Метод ТекущаяКолонка в тексте программного модуля можно использовать синтаксически как функцию или процедуру. Данный метод позволяет установить и/или считать текущее положение курсора в элементе диалога типа «ТаблицаЗначений».
Данный метод можно использовать только для объектов, которые созданы при помощи визуальных средств конфигуратора (в форму вставлены элементы диалога «ТаблицаЗначений», а идентификаторы этих элементов доступны в контексте программного модуля этой формы как уже существующие объекты типа «ТаблицаЗначений»).
Пример:
Перем НомКолонки;
ТаблДиалога.ТекущаяКолонка(2, НомКолонки);
Фиксировать в элементе диалога типа «ТаблицаЗначений» колонки и строки.
Синтаксис:
Фиксировать(<КолСтрок>, <КолКолонок>)
Англоязычный синоним:
Fix
Параметры:
|
<КолСтрок> |
Необязательный параметр. Количество фиксируемых строк. Если не указаны, то не изменять фиксацию. |
|
<КолКолонок> |
Необязательный параметр. Количество фиксируемых колонок. Если не указаны, то не изменять фиксацию. |
Описание:
Метод Фиксировать позволяет фиксировать в элементе диалога типа «ТаблицаЗначений» колонки и строки.
Пример:
ТаблДиалога.Фиксировать(1, 1);
Выводить в элементе диалога типа «ТаблицаЗначений» пиктограммы.
Синтаксис:
ВыводитьПиктограммы(<Колонка>, <Пиктограмма>)
Англоязычный синоним:
Showlmages
Параметры:
|
<Колонка> |
Номер или идентификатор колонки, которая содержит номера пиктограмм. |
|
<Пиктограмма> |
Необязательный параметр. Начальный номер пиктограммы. Значение по умолчанию: 1. |
Описание:
Метод ВыводитьПиктограммы устанавливает режим, при котором в колонке выводится не текст, а пиктограмма. Пиктограмма будет браться из картинки, назначенной элементу диалога «ТаблицаЗначений» в закладке «Картинка» в конфигураторе. Картинка должна быть формата .bmp, содержать все пиктограммы для этой таблицы значений, и состоять из последовательности пиктограмм размером 16х15 пикселей. Пиктограммы будут выбираться из картинки по номеру, взятому из числового значения данной колонки в текущей строке. Параметр <Пиктограмма> позволяет установить для данной колонки начальный номер пиктограмм в картинке.
Пример:
ТаблДиалога.ВыводитьПиктограммы(1, 1);
Пример:
Функция ВыбратьОплаты(ВыбДок)
ТЗ = СоздатьОбъект("ТаблицаЗначений");
ТЗ.НоваяКолонка("ДатаДок", "Дата", , , "Дата", 15);
ТЗ.НоваяКолонка("Номер", "Строка", 20, , "Номер", 15);
ТЗ.НоваяКолонка("Сумма", "Число", 18, 2, "Сумма", 20);
ТЗ.НоваяКолонка("РасчетныйСчет", "Справочник.БанковскиеСчета", , ,
"Расч.счет", 30);
ТЗ.НоваяКолонка("ПодчДок", "Документ", , , );
ТЗ.ВидимостьКолонки("ПодчДок", 0);
Док = СоздатьОбъект("Документ");
Док.ВыбратьПодчиненныеДокументы(, , ВыбДок);
Пока Док.ПолучитьДокумент() = 1 Цикл
Если Док.Вид() = "ОплатаПоставщикам" Тогда
ТЗ.НоваяСтрока();
ТЗ.ДатаДок = Док.ДатаДок;
ТЗ.Номер = Док.НомерДок;
ТЗ.Сумма = Док.Итог("Сумма");
ТЗ.РасчетныйСчет = Док.РасчетныйСчет;
ТЗ.ПодчДок = Док.ТекущийДокумент();
КонецЕсли;
КонецЦикла;
ВыбСтрока = 0;
Если ТЗ.ВыбратьСтроку(ВыбСтрока, "Выберите оплату") = 1 Тогда
Возврат ТЗ.ПолучитьЗначение(ВыбСтрока, "ПодчДок");
КонецФункции
