Методы
Синтаксис:
ВставитьОбласть(< Исходная область>, <Область приемник>, <Сдвиг>)
Параметры:
<Исходная область> Обязательный
Тип: ОбластьЯчеекТабличногоДокумента. Исходная область.
<0бласть приемник> Необязательный
Тип: ОбластьЯчеекТабличногоДокумента. Область-приемник.
Значение по умолчанию: Если параметр не задан, то сразу за исходной областью.
<Сдвиг> Необязательный
Тип: ТипСмещенияТабличногоДокумента. Определяет смещение ячеек таблицы при вставке.
Значение по умолчанию: БезСмещения.
При определении значения параметра используется системное перечисление ТипСмещенияТабличногоДокумента.
Описание:
Вставляет копию исходной области табличного документа в область-приемник.
Примечание:
Если размеры исходной области не соответствуют результирующей области, то при выполнении метода возникает ошибка.
Пример:
ТабДок = Новый ТабличныйДокумеит;
ИТОГ = 0;
Для К=1 По 10 Цикл
ТабДок.Область("R" + (K+1) +"С1").Текст = "Строка "+К;
ТабДок.О6ласть("R" + (К+1) + "С2").Текст = К*10;
Итог = Итог+К*10;
КонецЦикла;
ТабДок.ВставитьОбласть(ТабДок.Область("R2"), ТабДок.Область("R3"),
ТипСмещенияТабличногоДокумента.ПоГоризонтали);
ТабДок.Область("R2C1").Текст = "Итого:";
ТабДок.Область("R2C2").Текст = Итог;
Рамка = Новый Линия(ТипЛинииЯчейкиТабличногоДокумента.Сплошная, 1);
ТабДок.Область("R2С1:R2С2").Обвести(,Рамка,,Рамка);
ТабДок.ОтображатьСетку = Ложь;
ТабДок.Защита = Ложь;
ТабДок.ТолькоПросмотр = Истина;
ТабДок.Показать("Пример использования метода ВставитьОбласть()");
Синтаксис:
Вывести (< Таблица>, <Уровень> , <Имя группы>, <Открыта>)
Параметры:
<Таблица> Обязательный
Тип: ТабличныйДокумент. Выводимая таблица.
<Уровень> Необязательный
Тип: Число. Уровень используется для автоматической группи ровки строк табличного документа. Соседние строки с одинаковым уровнем будут отнесены к одной группе.
<Имя группы> Необязательный
Тип: Строка. Название группы, к которой относятся выводимые строки.
Значение по умолчанию: Пустая строка.
<Открыта> Необязательный
Тип: Булево. Истина - выведенная группа будет открыта, Ложь - группа будет выведена в свернутом виде.
Значение по умолчанию: Истина.
Описание:
Выводит табличный документ в результирующий табличный документ, добавляя его со следующей строки вслед за самой нижней выведенной строкой, начиная с первой колонки.
Пример:
ТабДок = Новый ТабличныйДокумент;
Секция = ТабДок.ПолучитьОбласть("R1");
Секция.Область("R1C1").Текст = "Численность сотрудников";
ТабДок.НачатьАвтогруппировкуСтрок();
ТабДок.Вывести(Секция,1,"Группа",Истина);
Итого = 0;
Для Н=1 По 3 Цикл
Значение = Н; Итог = 0;
Секция.Область("R1С1").Текст = "Отдел "+Н;
Секция.Область("R1C2") .Текст = "";
ТабДок.Вывести(Секция,2,"Группа 1",Истина);
Секция.Область("R1C1").Текст = "Группа";
Секция.Область("R1C2") .Текст = "Численность";
ТабДок.Вывести(Секция,2,"Группа 1",Истина);
Для К=1 По 10 Цикл
Секция.Область("R1C1").Текст = "А"+Н+К;
Секция.Область("R1C2").Текст = Значение;
ТабДок.Вывести(Секция,3,"Группа 2",Истина);
Итог = Итог + Значение;
Значение = Значение + 10;
КонецЦикла;
Секция.Область("R1C1").Текст = "Итого"+Н;
Секция.Область("R1C2").Текст = Итог;
ТабДок.Вывести(Секция,2,"Группа 1",Истина);
Секция.Область("R1C1:R1C2").Текст = "";
ТабДок.Вывести(Секция);
Итого = Итого + Итог;
КонецЦикла;
Секция.Область("R1С1").Текст = "Всего:";
Секция.Область("R1C2").Текст = Итого;
ТабДок.Вывести(Секция,1,"Группа",Истина);
ТабДок.ЗакончитьАвтогруппировкуСтрок();
ТабДок.ИтогиСнизу = Истина;
ТабДок.ОтображатьСетку = Ложь;
ТабДок.Защита = Ложь;
ТабДок.ТолькоПросмотр = Истина;
ТабДок.Показать("Пример использования верт. группировки");
См. также:
ТабличныйДокумент, метод Присоединить.
ВывестиВертикальныйРазделительСтраниц (PutVerticalPageBreak)
Синтаксис:
ВывестиВертикальныйРазделительСтраниц()
Описание:
Вставляет в результирующую таблицу вертикальный разделитель страниц.
Пример:
ТабДок.ВывестиВертикальныйРазделительСтраниц() ;
ВывестиГоризонтальныйРазделительСтраниц (PutHorizontalPageBreak)
Синтаксис:
ВывестиГоризонтальныйРазделительСтраниц()
Возвращаемое значение:
Тип: Число.
Описание:
Вставляет в результирующую таблицу горизонтальный разделитель страниц.
Пример:
ТабДок.ВывестиГоризонтальныйРазделительСтраниц() ;
ЗакончитьАвтогруппировкуКолонок (EndColumnsAutoGroup)
Синтаксис:
ЗакончитьАвтогруппировкуКолонок()
Описание:
Заканчивает автоматическую группировку колонок, ранее начатую методом НачатьАвтогруппировкуКолонок.
Пример:
ТабДок.ЗакончитьАвтогруппировкуКолонок();
См. также:
ТабличныйДокумент, метод НачатьАвтогруппировкуКолонок.
ЗакончитьАвтогруппировкуСтрок(EndRowsAutoGroup)
Синтаксис:
ЗакончитьАвтогруппировкуСтрок()
Описание:
Заканчивает автоматическую группировку строк, ранее начатую при помощи метода НачатьАвтогруппировкуСтрок.
Пример:
ТабДок.ЗакончитьАвтогруппировкуСтрок() ;
См. также:
ТабличныйДокумент, метод НачатьАвтогруппировкуСтрок.
3aкончитьГруппуКолонок(EndColumnsGroup)
Синтаксис:
ЗакончитьГруппуКолонок()
Описание:
Закадчивает последнюю из начатых ранее групп колонок.
Пример:
ТабДок.НачатьГруппуКолонок("По всем складам", Истина);
//...
ТабДок.начатьГруппуКолонок("На складе", Истина);
//...
ТабДок.ЗакончитьГруппуКолонок (); // окончить группу "На складе"
ТабДок.ЗакончитьГруппуКолонок(); // окончить группу "По всем складам"
См. также:
ТабличныйДокумент, метод НачатьГруппуКолонок.
ЗакончитьГруппуСтрок(EndRowsGroup)
Синтаксис:
ЗакончитьГруппуСтрок()
Описание:
Заканчивает последнюю из начатых ранее групп строк.
Пример:
ТабДок.НачатьГруппуСтрок("Сводно за месяц", Истина);
ТабДок.НачатьГруппуСтрок("По дням", Истина);
//...
ТабДок. ЗакончитьГруппуСтрок (); // закончить группу "По дням"
ТабДок.ЗакончитьГруппуСтрок(); // закончить группу "Сводно за месяц"
См. также:
ТабличныйДокумент, метод НачатьГруппуСтрок.
Записать (Write)
Синтаксис:
Записать(<Имя файла>. <Тип файла таблицы> )
Параметры:
<Имя файла> Обязательный
Тип: Строка. Имя файла, в котором сохраняется табличный документ.
<Тип файла таблицы> Необязательный
Тип: ТипФайлаТабличногоДокумента. Формат, в котором будет сохранен табличный документ.
Значение по умолчанию: MXL.
При определении значения параметра используется системное перечисление ТипФайлаТабличногоДокумента.
Описание:
Записывает табличный документ в файл.
Пример:
ТабДок.Записать("С: \Му Documents \Таблица2.mxl ");
НайтиЗначение (FindValue)
Синтаксис:
Найти3начение(<3начение> , <Начало> , <Где>, <Искать по строкам>, <Искать вперед>)
Параметры:
<3начение> Обязательный
Тип: Произвольный. Искомое значение.
<Начало> Необязательный.
Тип: ОбластьЯчеекТабличногоДокумента. Область, после которой начинать поиск.
Значение по умолчанию: Если параметр не задан, то поиск с начала таблицы.
<Где> Необязательный
Тип: ОбластьЯчеекТабличногоДокумента. Область, в которой осуществляется поиск.
Значение по умолчанию: Если параметр не задан, то поиск во всей таблице.
<Искать по строкам> Необязательный
Тип: Булево. Определяет последовательность обхода ячеек при поиске.
Истина - искать по текущей строке, затем переходить на следующую и т.д. в общем направлении поиска. Ложь - искать по текущему столбцу, затем переходить на следующий и т.д. в общем направлении поиска.
Значение по умолчанию: Истина.
<Искать вперед> Необязательный
Тип: Булево. Направление поиска:
Истина - искать вперед, Ложь - искать назад. Значение по умолчанию: Истина.
Возвращаемое значение:
Тип: ОбластьЯчеекТабличногоДокумента, РисунокТабличногоДокумента. Область, содержащая искомое значение. Если значение не найдено - значение Неопределено.
Описание:
Позволяет искать значение в ячейках табличного документа.
Пример:
Если Не ТабДок.НайтиЗначение(ВыбЗнач) Тогда
Сообщить("Значение не найдено!");
Иначе
Сообщить("Значение найдено.");
КонецЕсли;
НайтиТекст (FindText)
Синтаксис:
НайтиТекст(< Строка>, <Начало>, <Где>, <Искать по строкам>, <Ячейка целиком> , <Искать вперед> , <Чувствительность к регистру> )
Параметры:
<Строка> Обязательный
Тип: Строка. Искомый текст.
<Начало> Необязательный
Тип: ОбластьЯчеекТабличногоДокумента. Область, после которой начинать поиск.
Значение по умолчанию: Если параметр не задан, то поиск с начала таблицы.
<Где> Необязательный
Тип: ОбластьЯчеекТабличногоДокумента. Область, в которой осуществляется поиск.
Значение по умолчанию: Если параметр не казан, то вся таблица.
<Искать по строкам> Необязательный
Тип: Булево. Определяет последовательность обхода ячеек при поиске.
Истина - искать по текущей строке, затем переходить на следующую и т.д. в общем направлении поиска. Ложь - искать по текущему столбцу, затем переходить на следующий и т.д. в общем направлении поиска.
Значение по умолчанию: Истина.
<Ячейка целиком> Необязательный
Тип: Булево. Истина - искать только такие ячейки, в которых с искомым текстом совпадает весь текст ячейки, Ложь -искать часть текста ячейки.
Значение по умолчанию: Ложь.
<Искать вперед> Необязательный
Тип: Булево. Направление поиска:
Истина - искать вперед, Ложь - искать назад.
Значение по умолчанию: Истина.
<Чувствительность к регистру> Необязательный
Тип: Булево. Истина - поиск с учетом регистра. Ложь - без учета регистра.
Значение по умолчанию: Ложь.
Возвращаемое значение:
Тип: ОбластьЯчеекТабличногоДокумента, РисунокТабличногоДокумента. Область, содержащая искомый текст. Если текст не найден - значение Неопределено.
Описание:
Позволяет искать текст в ячейках табличного документа.
Пример:
// чтобы посмотреть работу данного метода, добавьте
// следующие строки в конец примера метода НачатьГруппуСтрок()
Отдел = "Итого2";
Обл=ТабДок.НайтиТекст(Отдел);
Если ТипЗнч(Обл)=Тип("Неопределено") Тогда
Сообщить("Значение не найдено!");
Иначе
Поз = Найти(Обл.Имя,"С");
Имя= Лев(Обл.Имя,Поз)+Строка(Число(Прав(Обл.Имя,СтрДлина(Обл.Имя)-Поз) )+1);
Сообщить ("Итог по отделу 2 = " + ТабДок.Область(Имя).Текст);
КонецЕсли;
Напечатать (Print)
Синтаксис:
Напечатать(<Диалог печати> )
Параметры:
<Диалог печати> Необязательный
Тип: Булево. Показ диалога перед печатью:
Истина - выводить диалог печати. Ложь - не выводить диалог печати.
Значение по умолчанию: Ложь.
Описание:
Выводит табличный документ на печать.
Пример:
ТабДок.Напечатать();
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
