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

0

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

Возвращает 1, если значение знач найдено, или 0  в  противном  случае.  Параметры  номСтроки  и иден  | номСтолбца являются входными/выходными. В качестве результата

эти параметры  возвращают координаты ячейки, содержащей искомое  значение.  Если

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

|  номСтолбца)  отличен  от  нуля  или  пустого  значения  (иден  не является  пустой  строкой),

и  выходит за  границы  таблицы  (или  иден задает несуществующий  идентификатор  столбца),

то возникнет завершающая ошибка

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

Комментарий

тЗнач.Сортировать(столбцы, [поДате]);

Если значения таблицы это документы и поДате =  1, то документы  сортируются по дате, в противном случае по значению. Значение

по умолчанию 0

тЗнач.Очистить();

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

номерСтроки   принимает  нулевое  значение

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

в примере 3 после табл. 3.7

тЗнач.Заполнить(знач, [начСтрока], [конСтрока], [столбцы]);

Если хотя  бы один из  последних  трех параметров  метода  задан  с ошибкой, то возникнет завершающая ошибка

тЗнач.Свернуть(групСтолбцы, сумСтолбцы);

Столбцы, которых нет в символьных выражениях групСтолбцы  и сумСтолбцы,

будут отсутствовать в  результирующей  таблице

значений  (см.  пример 4 после  табл.  3.7)

тЗнач.Выгрузить(новОбъект, [начСтрока], [конСтрока], [столбцы]);

Если хотя бы один из последних трех параметров метода  задан  с ошибкой,

то возникнет завершающая ошибка. Порядок употребления метода  иллюстрирует приводимый ниже пример 5

тЗначПриемник.Загрузить(тЗначИсточник);

Данные переносятся из таблицы

тЗначИсточник  в   таблицу   тЗначПриемник

флаг = тЗнач.ВидимостьКолонки(столбцы,

[видимость], [позиция]);

Если  параметр столбцы  содержит  один столбец, то возвращает флаг видимости этого столбца до вызова  метода; флаг равен единице, если столбец виден, или нулю  в противном случае.  Если  параметр  столбцы  задает несуществующий  столбец или  параметр

позиция  указывает на  несуществующую

позицию, то метод  игнорируется

номСтрокиДо =  тЗнач.ТекущаяСтрока

([номСтроки]);

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

иденДо|номСтолбцаДо = тЗнач.ТекущаяКолонка ([иден|номСтолбца], [номСтолбцаДо]);

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

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

Комментарий

тЗнач.Фиксировать

([колСтрок], [колСтолбцов]);

Если  параметр  колСтрок задан,  то  после применения метода в элементе диалога Таблица значений  будут недоступны  первые  колСтрок таблицы. Если  параметр отсутствует, то число недоступных  строк  не  изменяется. Аналогично на столбцы элемента диалога Таблица значений  действует  параметр колСтолбцов. Вызов тЗнач.Фиксировать(0, 0); делает доступными

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

тЗнач.ВыводитьПиктограммы (идеи  |  номСтолбца,  [начНомПиктограммы   ]);

Пиктограммы, имеющиеся в подсоединенном к элементу диалога Таблица значений ВМР файле, это  последовательность растровых образов размера  16×15  видеопикселов. Обращение к образу осуществляется по  его номеру в этой последовательности. Если ячейка А столбца  иден | номСтолбца содержит число а, то в этой  ячейке отобразится пиктограмма

с номером  начНомПиктограммы + а   1. Если

начНомПиктограммы + а 1  меньше единицы или больше числа пиктограмм в ВМР-файле,

то ячейка А останется незаполненной

Замечания:

1.             Имя  тЗнач таблицы значений, употребленное в табл. 3.6 перед названиями методов, может быть произвольным.

2.              Параметры методов, если это не оговаривается особо, являются входными.

3.             Как  и  во  всех методах, процедурах  или  функциях, входные параметры являются выражениями соответствующих типов.

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

Таблица 3.7

Параметр

Описание

видимость

Если равен нулю, то столбцы, перечисленные в  параметре

столбцы метода ВидимостьКолонки,  будут скрыты,  или  видимы в  противном случае

выравнивание

Если выравнивание =  1, то данные  в  столбце выравниваются по левой стороне,  и по правой, если выравнивание = 2

групСтолбцы

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

длина

Число символов для представления числовых или символьных данных

заг

Заголовок  столбца

загДиалога

Заголовок диалогового окна

знач

Значение ячейки таблицы значений

Параметр

Описание

идеи

Идентификатор столбца

колСтрок

Число фиксируемых строк элемента  диалога Таблица значений

колСтолбов

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

конСтрока

Номер строки, в которой завершается заполнение или копирование таблицы значений  (методы Заполнить  или  Выгрузить).  Если параметр отсутствует, то заполнение (копирование)  выполняется

до последней  строки включительно

начНомПиктограммы

Номер  первого образа BMP-файла, отображаемого в ячейках заданного  столбца элемента  диалога Таблица значений

начСтрока

Номер строки, с которой начинается заполнение или копирование таблицы значений (методы Заполнить или Выгрузить). Если параметр  отсутствует, то заполнение (копирование) осуществляется с первой  строки

новОбъект

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

номНовСтолбца

Номер  нового столбца

номСтолбца

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

номСтолбцаДо

Номер  текущего столбца таблицы значений до  применения метода ТекущаяКолонка

номСтроки

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

по Дате

Флаг задания сортировки документов, содержащихся в таблице значений, по дате

позиция

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

числоСтобцов

Новое число столбцов, устанавливаемое методом КоличествоКолонок

числоСтобцовДо

Старое число столбцов, возвращаемое методом КоличествоКолонок

числоСтрок

Число строк  в таблице значений, устанавливаемое методом КоличествоСтрок

столбцы

Символьное выражение, содержащее разделенные запятыми идентификаторы или номера столбцов, по которым выполняется сортировка (метод  Сортировать),  или  в которых изменяются значения  ячеек  (метод  Заполнить),  или из которых копируются данные (метод  Выгрузить).  В  методе  Сортировать  перед идентификатором  (номером) столбца может  стоять  знак  + или -.’ Если  перед идентификатором (номером)  столбца знака нет или стоит знак +, то сортировка выполняется по возрастанию, если расположен знак  -, то по убыванию (см.  пример 3 после настоящей таблицы).   Если  переченьСтолбцов  содержит  неверный  идентификатор или номер столбца, то возникнет завершающая ошибка

Параметр

Описание

сумСтолбцы

Столбцы, данные в которых  суммируются при объединении строк  по столбцам, заданным параметром групСтолбцы

тип

Тип, возможно  агрегатных, данных, отображаемых в столбце

точность

Число знаков после десятичной точки в представлении числовых данных

формат

Формат представления данных.  Форматирование осуществляется по правилам, изложенным в разд. 2.8.5

ширина

Число символов, отводимое под столбец  при отображении таблицы значений в диалоге

номВыбСтроки

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

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

процедура  Вывести()

// тЗнач переменная модуля, поэтому доступна в процедуре Вывести

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

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

// Перебор строк таблицы значений начинается с ее первой строки пока тЗнач.ПолучитьСтроку() = 1 цикл

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

По теме:

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