1С Предприятие 8.0. Описание встроенного языка

Методы


ВставитьОбласть (InsertArea)

Синтаксис:

ВставитьОбласть(< Исходная область>, <Область приемник>, <Сдвиг>)

Параметры:

<Исходная область>             Обязательный

Тип: ОбластьЯчеекТабличногоДокумента. Исходная об­ласть.

<0бласть приемник>              Необязательный

Тип:    ОбластьЯчеекТабличногоДокумента.    Область-приемник.

Значение по умолчанию: Если параметр не задан, то сразу за ис­ходной областью.

<Сдвиг>             Необязательный

Тип: ТипСмещенияТабличногоДокумента. Определяет сме­щение ячеек таблицы при вставке.

Значение по умолчанию: БезСмещения.

При определении значения параметра используется системное перечисление ТипСмещенияТабличногоДокумента.



Описание:

Вставляет копию исходной области табличного документа в об­ласть-приемник.

Примечание:

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

Пример:

ТабДок = Новый ТабличныйДокумеит;

ИТОГ = 0;

Для К=1 По 10 Цикл

    ТабДок.Область("R" + (K+1) +"С1").Текст = "Строка "+К;

    ТабДок.О6ласть("R" + (К+1) + "С2").Текст = К*10;

    Итог = Итог+К*10;

КонецЦикла;

ТабДок.ВставитьОбласть(ТабДок.Область("R2"), ТабДок.Область("R3"),

    ТипСмещенияТабличногоДокумента.ПоГоризонтали);

ТабДок.Область("R2C1").Текст = "Итого:";

ТабДок.Область("R2C2").Текст = Итог;

Рамка = Новый Линия(ТипЛинииЯчейкиТабличногоДокумента.Сплошная, 1);

ТабДок.Область("R2С1:R2С2").Обвести(,Рамка,,Рамка);

ТабДок.ОтображатьСетку = Ложь;

ТабДок.Защита = Ложь;

ТабДок.ТолькоПросмотр = Истина;

ТабДок.Показать("Пример использования метода ВставитьОбласть()");

Вывести (Place)




Синтаксис:

Вывести (< Таблица>, <Уровень> , <Имя группы>, <Открыта>)

Параметры:

<Таблица>             Обязательный

Тип: ТабличныйДокумент. Выводимая таблица.

<Уровень>             Необязательный

Тип: Число. Уровень используется для автоматической группи­ ровки строк табличного документа. Соседние строки с одинако­вым уровнем будут отнесены к одной группе.

<Имя группы>            Необязательный

Тип: Строка. Название группы, к которой относятся выводимые строки.

Значение по умолчанию: Пустая строка.

<Открыта>             Необязательный

Тип: Булево. Истина - выведенная группа будет открыта, Ложь - группа будет выведена в свернутом виде.

Значение по умолчанию: Истина.

Описание:

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

Пример:

ТабДок = Новый ТабличныйДокумент;

Секция = ТабДок.ПолучитьОбласть("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 »»»»»»»»»»

Содержание раздела