Главная » 1С Предприятие » МЕТОДЫ ТАБЛИЦЫ ЗНАЧЕНИЙ – ЧАСТЬ 1

0

Методы приведем  в  трех  таблицах.  В  первой (табл.  3.5)   перечислим сами  методы с указанием их назначения; во  второй  (табл. 3.6)  синтаксис  вызова  методов, а в третьей  (табл. 3.6)  описание (в алфавитном порядке)  их параметров.

Методы таблицы значений

Таблица 3.5

Метод

Что делает

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

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

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

Добавляет в таблицу значений вслед за последним столбцом  новый столбец

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

Вставляет  в таблицу значений  столбец с заданным номером

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

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

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

Изменяет параметры  столбца

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

Возвращает номер или идентификатор столбца,  а через параметры  метода параметры  столбца таблицы значений

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

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

НоваяСтрока

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

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

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

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

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

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

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

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

Осуществляет переход на следующую строку таблицы значений.

Может употребляться как  с методом ВыбратьСтроки, так и самостоятельно, например после метода ПолучитьСтрокуПоНомеру (см.  пример  2 после табл.  3.7)

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

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

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

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

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

Перемещает  текущую  или  заданную  параметром  номСтроки

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

Метод

Что делает

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

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

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

Возвращает значение  ячейки таблицы значений

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

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

Сортировать

Сортирует таблицу значений. Правила сортировки  задаются символьным  выражение, содержащим идентификаторы  и/или номера столбцов, например "КодПоставщика, +Материал, -3".

Если  перемещается текущая строка, то и  соответствующим образом меняется   значение  атрибута  номерСтроки

Очистить

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

Итог

Суммирует  значения  заданного столбца

Заполнить

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

Свернуть

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

Выгрузить

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

Загрузить

Копирует целиком одну таблицу в другую. После применения метода  Загрузить  таблица-приемник  будет  содержать только те столбцы и строки, которые имеет таблица-источник

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

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

на элемент диалога Таблица значений  (рис.  3.9)  и диалог, отображаемый  методом  ВыбратьСтроку

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

Устанавливает/возвращает в  элементе  диалога Таблица значений строку, в  которой отображается  курсор. Значение  атрибута номерСтроки метод  не  меняет

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

Устанавливает/возвращает  в элементе диалога Таблица  значений  столбец,  в  котором отображается курсор.  Результат применения методов ТекущаяСтрока и ТекущаяКолонка приведен на рис. 3.9

Фиксировать

Делает недоступными  в  элементе диалога Таблица значений заданное  число строк и столбцов

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

Выводит в  заданном столбце элемента диалога  Таблица  значений  вместо занесенных  в  него данных пиктограммы из ВМР-файла, подсоединенного к элементу диалога в закладке Картинка  в окне Свойства таблицы. Порядок  создания и употребления пиктограмм разбирается в примере 8 после табл. 3.7

Синтаксис вызова методов таблицы  значений

Таблица 3.6

Синтаксис вызова

Комментарий

числоСтобцовДо = тЗнач.КоличествоКолонок ([числоСтобцов]);

Число столбцов не меняется,  если параметр

числоСтобцов не  задан

номНовСтолбца =  тЗнач.НоваяКолонка ([иден], [тип], [длина], [точность],  [заг], [ширина], [формат],  [выравнивание]);

Если тип не задан, то в добавляемом столбце можно  хранить любой тип

номНовСтолбца = тЗнач.ВставитьКолонку ([иден], [номНовСтолбца], [тип], [длина],  [точность], [заг], [ширина], [формат],  [выравнивание]);

Если идентификатор не задан, то обращение  к столбцу выполняется по его номеру

тЗнач.УдалитьКолонку(иден | номСтолбца);

В качестве параметра передается  либо идентификатор, либо номер столбца

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

(иден   | номСтолбца,

[тип], [длина], [точность], [заг], [ширина], [формат], [выравнивание]);

Значение  параметра столбца сохраняется, если опущен  соответствующий  ему  параметр  метода

иден | номСтолбца  = тЗнач.ПолучитьПараметрыКолонки (номСтолбца | иден,  [тип], [длина], [точность],[заг], [ширина],  [формат], [выравнивание]);

Возвращает идентификатор столбца,  если первый  параметр это номер столбца, и номер столбца, если первый параметр это идентификатор столбца.  Все параметры,  кроме первого,  являются  выходными

числоСтрокДо = тЗнач.КоличествоСтрок ([числоСтрок]);

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

номНовойСтроки = тЗнач.НоваяСтрока ([номНовойСтроки]);

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

тЗнач.УдалитьСтроку([намСтроки]);

Если  параметр  номСтроки не  задан,  то удаляется текущая строка.  Изменение текущей строки осуществляется, например, методом ПолучитьСтрокуПоНомеру (разд. 3.4.3)

тЗнач.УдалитьСтроки();

После выполнения  значение  атрибута

номерСтроки равно  нулю

тЗнач.ВыбратьСтроки();

Часто  предшествует методу  ПолучитьСтроку

Синтаксис вызова

Комментарий

флаг = тЗнач.ПолучитьСтроку();

Вернет  1, если удалось переместиться на

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

флаг  = тЗнач.ВыбратьСтроку ([номВыбСтроки], [загДиалога], [задержка]);

Возвращает:

1, если нажата  кнопка ОК;

0, если нажата кнопка  Отмена;

-1, если закончилось время, заданное параметром задержка.

Параметр номВыбСтроки входной/выходной.

При вызове метода курсор  позиционируется

на  строке, номер которой равен  номВыбСтроки,  или на первой строке, если значение номВыбСтроки лежит  вне диапазона

[1,   тЗнач.КоличествоСтрок();]

тЗнач.ПолучитьСтрокуПоНомеру (номСтроки);

Если номер строки номСтроки  выходит за

пределы диапазона [1, тЗнач.КоличествоСтрок();], то возникнет завершающая ошибка, сопровождаемая сообщением "Номер

за пределами значения!"

номНовойСтроки = тЗнач.СдвинутьСтроку (числоСтрок, [номСтроки]);

Если  номСтроки не задан,  то  перемещается  текущая строка. Если  числоСтрок  > 0, то строка перемещается  вниз таблицы. Иначе, если числоСтрок < 0, в  верх таблицы. Строка

станет последней  (первой),  если  числоСтрок

задает  позицию за пределами таблицы значений

тЗнач.УстановитьЗначение(номСтроки,

иден | номСтолбца,  знач);

Ячейка, в которой устанавливается значение, задается номером строки и идентификатором или номером столбца. Если эти параметры заданы с ошибкой, то возникнет завершающая вычисления ошибка

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

{номСтроки, иден  | номСтолбца);

Ячейка,  значение которой возвращается методом,  задается номером  строки и идентификатором или номером  столбца. Завершающая  ошибка  возникает в тех же случаях, что  и для  метода  УстановитьЗначение

флаг = тЗнач.НайтиЗначение(знач,

Источник: Бартеньев О. В. 1С:Предприятие:  программирование для  всех.  Базовые объекты и расчеты на одной дискете. М.: Диалог-МИФИ, 2005. 464 с.

По теме:

  • Комментарии