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

ОсвободитьЗапись


Снимает фиксацию с текущей записи журнала расчетов.

Синтаксис:

ОсвободитьЗапись()

Англоязычный синоним:

ReleaseRecord

Возвращаемое значение:

Число: 1 — если операция успешно выполнена; 0 — в противном случае.

Описание:

Метод снимает фиксацию с текущей записи журнала расчетов. После при менения этого метода атрибут записи Фиксирована принимает значение 0. Действие, обратное фиксации записи, фактически, означает возможность редактирования результата ее расчета.

Пример:

Если ЖрнЗарплата.Фиксирована = 1 Тогда

   Если ДатаДок > ЖрнЗарплата.НачалоТекущегоПериода() Тогда

      ОсвободитьЗапись();

   Иначе

      // отказ от расчета!

      // ....

   КонецЕсли;

КоненцЕсли;

См. также: Фиксирована, ФиксироватьЗапись



Отчет по неходовым товарам




Далее приведен пример нетривиального использования запроса для про­смотра одновременно многих видов документов. Цель данной процедуры — вывести в отчет перечень неходовых товаров, которые совсем не продавались за заданный период и показать в каждой строке текущий остаток и стоимость этих товаров. В данном примере запрос формируется с целью определить, что в него не вошло.

Процедура Сформировать()

   Перем Запрос, ТекстЗапроса, Таб;

   Рег = СоздатьОбъект("Регистр.ОстаткиТовара");

   Запрос = СоздатьОбъект("Запрос");

   ТекстЗапроса = "//{{ЗАПРОС(Сформировать)

   |Период С ДатаНачала По ДатаКонца;

   |ТОВАР = Документ.РасходнаяБН.Товар,

   |   Документ.РасходнаяКредит.Товар, Документ.РасходнаяНал.Товар,

   |   Документ.РасходнаяРеализ.Товар, Документ.Счет.Товар;

   |Группировка ТОВАР упорядочить по ТОВАР.Наименование без групп;

   |"//}}ЗАПРОС

   ;

   Если ДатаКонца >= ПолучитьДатуТА() Тогда

      ТекстЗапроса = ТекстЗапроса + "Период С ДатаНачала;";

   Иначе

      ТекстЗапроса = ТекстЗапроса + "Период С ДатаНачала По ДатаКонца;";

      Per.ВременныйРасчет();

      РассчитатьРегистрыНа(ДатаКонца);

   КонецЕсли;

   // Выполнение Запроса

   Если Запрос.Выполнить(ТекстЗапроса) = 0 Тогда

      Возврат;

   КонецЕсли;

   Тов = СоздатьОбъект("Справочник.Товары");

   // обход включая группировки

   Тов.ВключатьПодчиненные(1);

   // упорядочить по наименованиям

   Тов.ПорядокНаименозаний();

   ИтогоОстаток = 0;

   ИтогоСумма = 0;

   Таб = СоздатьОбъект("Таблица");

   Таб.ВывестиСекцию("Отчет");

   Состояние("В отчет выведено " + ЧислоСтрок + " строк.");

   // Запускаем полный цикл по товарам Справочника

   Тов.ВыбратьЭлементы();

   Пока Тов.ПолучитьЭлемент() > 0 Цикл

      Флаг = 0;

      Товар = Тов.ТекущийЭлемент();

      Если Товар.ЭтоГруппа() = 1 Тогда

         Продолжить;

      КонецЕсли;

      // Здесь пытаемся получить из Запроса информацию о товаре,




      // но используем просто сам факт того, что товар попал во

      // временный набор данных Запроса.

      // Если товар есть в Запросе, то значит он упоминался в

      // каких то документах,

      // иначе — товар не пользуется спросом — неходовой.

      Если Запрос.Получить(Товар) = 1 Тогда

         Продолжить;

      КонецЕсли;

      // находим остатки неходового товара на складе

      Рег.СводныеОстатки(Товар, );

      ТекОстаток = Рег.ОстатокТовара;

      ТекСумма = Рег.БазоваяСтоимость;

      Если ТекОстаток = 0 Тогда

         Продолжить;

      КонецЕсли;

      Таб.ВывестиСекцию("Товар");

      ИтогоОстаток = ИтогоОстаток + ТекОстаток;

      ИтогоСумма = ИтогоСумма + ТекСумма;

   КонецЦикла;

   Таб.ВывестиСекцию("Итоги");

   Таб.ТолькоПросмотр(1);

   Таб.Опции(0, 0, 3, 0);

   Таб.Показать("Отчет о неходовых товарах", "");

КонецПроцедуры

ДатаКонца = РабочаяДата();

ДатаНачала = ДатаКонца — Константа.ПериодАнализа;


Отчет по регистру с точностью до строки документа


Далее приведен пример использования запроса для просмотра регистра с выборкой документов, производивших движение данного регистра, с доступом к каждой строке этих документов. Цель данной процедуры — сформировать отчет, чтобы по каждому из видов топлива, отпущенных за заданный период покупателям, показать перечень номеров автомашин, которыми производилась отгрузка. Особенностью данного отчета является то, что номера автомашин не являются измерениями регистра, а зафиксированы в каждой строке отпускного документа.

Использование в описании внутренней переменной для регистра атрибута НомерСтроки, означает выборку связанных номеров строк тех документов, которые произвели движение по регистру (предполагается, что в конфигурации в Модулях документов перед движением данного регистра использовали метод ПривязыватьСтроку).

Процедура Сформировать()

   Перем Запрос, ТекстЗапроса, Таб;

   //Создание объекта типа Запрос

   Запрос = СоздатьОбъект("Запрос");

   ТекстЗапроса = "//{{ЗАПРОС(Сформировать)

   |Период с НачДата по КонДата;

   |ВидТоплива = Регистр.ПокупателиКолво.ВидыТоплива;

   |Вес = Регистр.ПокупателиКолво.Кг;

   |Покуп = Регистр.ПокупателиКолво.Покупатели;

   |Док = Регистр.ПокупателиКолво.ТекущийДокумент;

   |Ном = Регистр.ПокупателиКолво.НомерСтроки;

   |Группировка ВидТоплива;         //по измерению Регистра

   |Группировка Док;                // по документам, двигавшим Регистр

   |Группировка Ном;                //по номерам строк документов

   |Функция ВсегоКолво = КонОст(Вес);

   |Функция ПриходКолво = Приход(Вес);

   |Условие(Покуп = ВыбПокупатель);

   |"//}}ЗАПРОС

   ;

   // Если ошибка в запросе, то выход из процедуры

   Если Запрос.Выполнить(ТекстЗапроса) = 0 Тогда

      Возврат;

   КонецЕсли;

   // Заполнение выходных форм данными Запроса

   Таб = СоздатьОбъект("Таблица");

   Таб.ИсходнаяТаблица("Таблица1");

   Таб.ВывестиСекцию("Шапка");

   Пока Запрос.Группировка(1) = 1 Цикл




      // Отображаем значение измерения — ВидТоплива

      Таб.ВывестиСекцию("ВидТоплива");

      // запускаем вложенную группировку по документам,

      // которые производили движения Регистра

      Пока Запрос.Группировка(2) = 1 Цикл

         Док1 = Запрос.Док;

         // отфильтруем нужные нам документы

         Если НЕ(Док1.Вид() = "Продажа") Тогда

            Продолжить;

         КонецЕсли;

         // запускаем вложенную группировку по строкам

         // документа, связанным с движениями регистра

         Пока Запрос.Группировка(3) = 1 Цикл

            // Получаем в документе строку по найденному номеру

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

            Таб.ВывестиСекцию("Строка");

         КонецЦикла;

      КонецЦикла;

   КонецЦикла;

   // Вывод заполненной формы

   Таб.Опции(О, О, 0, 0);

   Таб.ТолькоПросмотр(1);

   Таб.Показать("", "");

КонецПроцедуры


Открыть


Открыть таблицу из файла.

Синтаксис:

Открыть(<ИмяФайла>)

Англоязычный синоним:

Open

Параметры:

<ИмяФайла>

Строковое выражение с именем файла.

Описание:

Метод Открыть открывает таблицу из файла с именем <ИмяФайла>.

Пример:

Таб = СоздатьОбъект("Таблица");

Таб.Открыть("\v7\db\src.mox");

Таб.Показать();



Открыть


Открыть текстовый файл.

Синтаксис:

Открыть(<ИмяФайла>)

Англоязычный синоним:

Open

Параметры:

<ИмяФайла>

Строковое выражение — имя файла.

Описание:

Метод Открыть открывает файл с именем <ИмяФайла>.

Пример:

ТекстДок = СоздатьОбъект("Текст");

ТекстДок.Открыть("catalog.txt");



Открыта


Прочитать значение флага открытия файла.

Синтаксис:

Открыта()

Англоязычный синоним:

IsOpen

Возвращаемое значение:

Число: 1 — база открыта; 0 — база не открыта.

Описание:

Метод Открыта возвращает значение флага открытия файла базы данных.

Пример:

См. предыдущий пример.



ОткрытьФайл


Открыть существующую базу.

Синтаксис:

ОткрытьФайл(<ПутьКБазе>, <ПутьКИндексу>, <ТолькоЧтение>)

Англоязычный синоним:

OpenFile

Параметры:

<ПутьКБазе>

Строковое выражение, содержащее путь к файлу базы данных формата DBF.

<ПутьКИндексу>

Необязательный параметр. Строковое выражение, содержащее путь к индексному файлу базы дан­ных.

<ТолькоЧтение>

Необязательный параметр. Число: 1 — файл от­крывается в режиме только чтение; 0 — файл открывается в режиме полного доступа (при этом файл открывается в эксклюзивном режиме). Значение по умолчанию — 0.

Описание:

Метод ОткрытьФайл открывает существующую базу данных формата DBF.

Пример:

// Подразумевается, что объект ДБФ уже создан и

// доступен в данном контексте

Процедура ОткрДБ()

   ИмяФайла = "";

   ИмяПути = "";

   ФС.ВыбратьФайл(0, ИмяФайла, ИмяПути, , "*.*", , );

   ПутьДБ = ИмяПути + ИмяФайла;

   ДБФ.ОткрытьФайл(ПутьДБ);

   Если ДБФ. Открыта() = 1 Тогда

      Предупреждение("База открыта", 2);

   Иначе

      Предупреждение("Не смогли открыть Базу!", 2);

   КонецЕсли;

КонецПроцедуры



ОткрытьФорму


Выполняет открытие формы из'встроенного языка.

Синтаксис:

ОткрытьФорму (<Параметр1>, <КонтекстФормы>, < Параметр 3>...)

Англоязычный синоним:

OpenForm

Параметры:

<Параметр1>

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

Для журналов, отчетов, списков в конце строки описателя формы может быть указан символ "#" с некоторым идентификатором: "#LLLL". Это используется для того, чтобы данная форма открылась в новом окне, а не активизировала существующее окно этой формы, если оно открыто. Где, LLLL — иден­тификатор, который позволяет открыть но­вое окно или активизировать уже открытое с этим идентификатором. Если идентификатор не задан, то обязательно открывается новое окно.
<КонтекстФормы>

 Необязательный параметр. Имя переменной, куда можно задать значение любого типа для передачи в открываемую форму. Данное зна­чение будет доступно в открытой форме как атрибут Форма.Параметр.

После исполнения данного метода система вернет в данную переменную контекст от­крытой формы (см. Передача контекста в качестве параметра). С помощью значения этого контекста можно затем произвольно манипулировать открытой формой, пока она открыта. Пока форма открыта, тип значения данного параметра равен 100 (см. ТипЗначения), если закрыта — 0.
<Параметр3>...

 В зависимости от типа открываемой формы используется различный состав и значения остальных параметров.

Возвращаемое значение:

Число 1 — если действие выполнено;

Число 0 — если действие не выполнено.

Описание:

Функция ОткрытьФорму позволяет открыть форму документа, справочни­ка, журнала документов, и других форм используемых в системе 1С:Предприятие.

Замечание. Для журналов, отчетов, списков в конце строки описателя формы может быть указан символ "#" с некоторым идентификатором: "#LLLL". Это используется для того, чтобы данная форма открылась в новом окне, а не активизировала существующее окно этой формы, если оно открыто. Где, LLLL — идентификатор, который позволяет открыть новое окно или активизировать уже открытое с этим идентификатором. Если идентифи­катор не задан, то обязательно открывается новое окно.




Замечание. Метод ОткрытьФорму нельзя вызывать в «теле» глобального мо­дуля ( части глобального модуля, расположенной после последней проце­дуры). Для его вызова при старте программы следует размещать его в процедуре ПриНачалеРаботыСистемы.

Для открытия разных форм следует использовать разный синтаксис вызова данной функции:

Открытие формы существующего документа.

ОткрытьФорму(<Документ>, <КонтекстФормы>, <РежимПросмотра>)

<Документ>

 Значение типа «Документ».
<РежимПросмотра>

 Необязательный параметр. Числовое выра­жение: 1 — открыть форму в режиме только просмотра; 0 — открыть форму в режиме редактирования. -1 (минус единица) в этом случае используется вариант предусмотрен­ный текущим значением параметра «Режим открытия объектов» установленного поль­зователем. По умолчанию — 0.

ОткрытьФормуМодально


Выполняет открытие модальной формы из встроенного языка.

Синтаксис:

ОткрытьФормуМодально(<Параметр1>, <КонтекстФормы>, <ПараметрЗ>...)

Англоязычный синоним:

OpenFormModal

Параметры: см. параметры метода ОткрытьФорму

Возвращаемое значение: см. метод ОткрытьФорму.

Описание:

Функция ОткрытьФормуМодально позволяет открыть модальную форму документа, справочника, журнала документов, и других форм используемых в системе 1С:Предприятие. Синтаксис и описание см. метод ОткрытьФорму.

См. также: ОткрытьФорму



Открытие формы нового документа


ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <ДокументОснование>)

<ОписательОбъекта>

 Строковое выражение.

"Документ.ХХХХХ", где ХХХХХ — идентификатор вида документа;
<ДокументОснование>

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

Открытие формы журнала документов.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>)

<ОписательОбъекта>

 Строковое выражение.

"Журнал . ХХХХХ. YYYYY", где ХХХХХ — идентификатор журнала докумен­тов; YYYYY — идентификатор формы журна­ла документов;

Кроме того, в качестве идентификатора жур­нала можно указывать идентификатор кон­кретного вида документа, тогда откроется журнал просмотра документов именно ука­занного вида, например:

ОткрытьФорму("Журнал.РасходнаяНакладная")

Открытие формы журнала подчиненных документов.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <Документ>)

<ОписательОбъекта>

 Строковое выражение. "Журнал.Подчиненные";
<Документ>

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

Открытие формы существующего элемента справочника.

ОткрытьФорму(<Элемент>, <КонтекстФормы>, <РежимПросмотра>)

<Элемент>

 Значение типа «Справочник».
<РежимПросмотра>

 Необязательный параметр. Числовое выра­жение: 1 — открыть форму в режиме только просмотра; 0 — открыть форму в режиме редактирования. -1 (минус единица) в этом случае используется вариант предусмотрен­ный текущим значением параметра «Режим открытия объектов» установленного поль­зователем. По умолчанию — 0.

Открытие формы нового элемента справочника.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы> , <ГруппаРодитель>,

<ФлагГруппы>, <ЭлементВладелец>)

<ОписательОбъекта>

 Строковое выражение.

"Элемент. ХХХХХ", где ХХХХХ — вид спра­вочника;
<ГруппаРодитель>

 Необязательный параметр. Выражение типа «справочник», задающий родительскую группу для открытия формы ввода нового элемента (группы) справочника.
<ФлагГруппы>

 Необязательный параметр. Числовое выра­жение, задающее форму ввода нового эле­мента (группы) справочника: 1 — ввод новой группы, 0 — ввод нового элемента. По умол­чанию — 0.
<ЭлементВладелец>

 Необязательный параметр. Выражение типа «справочник», задающий элемент справоч­ника-владельца для открытия формы ввода нового элемента (группы) подчиненного справочника.



Открытие формы списка справочника.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>)

<ОписательОбъекта>

 Строковое выражение.

"Справочник.ХХХХХ.YYYYY", где ХХХХХ — вид справочника, YYYYY — имя выбран­ной формы списка справочника;
Открытие формы отчета.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>)

<ОписательОбъекта>

 Строковое выражение. "Отчет. ХХХХХ" , где ХХХХХ — вид отчета;
Открытие формы обработки.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>)

<ОписательОбъекта>

 Строковое выражение. "Обработка.ХХХХХ", где ХХХХХ — вид обработки;
Открытие формы внешнего отчета.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <ИмяФайла>)

<ОписательОбъекта>

 Строковое выражение. "Отчет";
<ИмяФайла>

 Строковое выражение — полное имя файла внешнего отчета.
Открытие формы журнала расчетов.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>)

<ОписательОбъекта>

 Строковое выражение.

"ЖурналРасчетов. ХХХХХ", где ХХХХХ — вид журнала расчетов;
Открытие формы существующего счета.

ОткрытьФорму(<Счет>, <КонтекстФормы>, <РежимПросмотра>)

<Счет>

 Значение типа «Счет».
<РежимПросмотра>

 Необязательный параметр. Числовое выра­жение: 1 — открыть форму в режиме только просмотра; 0 — открыть форму в режиме редактирования. -1 (минус единица) в этом случае используется вариант предусмотрен­ный текущим значением параметра «Режим открытия объектов» установленного поль­зователем. По умолчанию — 0.
Открытие формы нового счета.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>)

<ОписательОбъекта>

 Строковое выражение.

"Счет. ХХХХХ" , где ХХХХХ — идентифика­тор плана счетов;
Открытие формы списка счетов (плана счетов).

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>)

<ОписательОбъекта>

 Строковое выражение.

"ПланСчетов.ХХХХ.YYYY", где ХХХХХ — идентификатор плана счетов; YYYYY — идентификатор формы плана сче­тов.
<


Открытие формы существующей операции.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <Документ>, <Проводка>,

<Корреспонденция>, <РежимПросмотра>)

<ОписательОбъекта>

 Строковое выражение. "Операция".
<Документ>

 Значение типа «документ», операция которого будет открываться.
<Проводка>

 Необязательный параметр. Числовое выра­жение — номер проводки, на которую нужно позиционировать курсор при открытии опе­рации.
<Корреспонденция>

 Необязательный параметр. Числовое выра­жение — номер корреспонденции указанной проводки, на которую нужно позициониро­вать курсор при открытии операции.
<РежимПросмотра>

 Необязательный параметр. Числовое выра­жение: 1 — открыть форму в режиме только просмотра; 0 — открыть форму в режиме редактирования. -1 (минус единица) в этом случае используется вариант предусмотрен­ный текущим значением параметра «Режим открытия объектов» установленного поль­зователем. По умолчанию — 0.
Открытие формы ввода новой операции.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <ТиповаяОперация>)

<ОписательОбъекта>

 Строковое выражение. "Операция".
<ТиповаяОперация>

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

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <Документ>, <Пров>, <Корр>)

<ОписательОбъекта>

 Строковое выражение.

"ЖурналОпераций.YYYYY", где YYYYY — идентификатор формы журнала операций;
<Документ>

 Значение типа «документ», операция кото­рого будет использована для первоначально­го позиционирования.
<Пров>

 Номер проводки, которая будет использова­на для первоначального позиционирования курсора, если в журнале операций использу­ется режим показа проводок.
<Корр>

 Номер корреспонденции, которая будет ис­пользована для первоначального позициони­рования курсора, если в журнале операций используется режим показа проводок.
<


Открытие формы журнала проводок.

ОткрытьФорму(<ОписательОбъекта>, <КонтекстФормы>, <Документ>, <Проводка>,

<Корреспонденция>)

<ОписательОбъекта>

 Строковое выражение.

"ЖурналПроводок.YYYYY", где YYYYY — идентификатор формы журнала проводок;
<Документ>

 Значение типа «документ», операция кото­рого будет использована для первоначально­го позиционирования.
<Проводка>

 Необязательный параметр. Числовое выра­жение — номер проводки операции, на кото­рую нужно в начале позиционироваться.
<Корреспонденция>

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

Открытие окна истории значений периодических констант, реквизитов справочников и счетов.


ОткрытьФорму("История.Константа.<ИдентКонстанты>", , , <УстНаДату>)

ОткрытьФорму("История.Справочник.<ИдентСправочника>, <ИдентРеквизита>", ,

<ЭлементСправочника>, <УстНаДату>)

ОткрытьФорму("История.Счет", , <Счет>, <УстНаДату>)

<ИдентКонстанты>

Идентификатор периодической константы, как он задан в конфигураторе.

<ИдентСправочника>

Идентификатор справочника, как он задан в конфигураторе.

<ИдентРеквизита>

Идентификатор периодического реквизита справочника, как он задан в конфигураторе.

<ЭлементСправочника>

Элемент справочника, для периодического реквизита которого открывается окно истории значений.

<Счет>

Счет, для которого открывается окно истории значений.

<УстНаДату>

Необязательный параметр. Дата, на которую нужно установить курсор при открытии ок­на.

Замечание. Допустимо включение в описатель открываемой формы уникаль­ного имени открываемой формы через символ "#" с некоторым произ­вольным идентификатором: "#LLLL". В этом случае открываемая форма закрепляется за выбранным объектом и не происходит обновление формы при смене объекта, например при смене текущей строки списка справочника.

Примеры:

Перем Конт;

ОткрытьФорму("История.Справочник.Сотр.Тариф#Ид01", , ТекущийЭлемент());

ОткрытьФорму(Докум, Конт);

ОткрытьФорму("Документ.РасхНакл");

ОткрытьФорму("Журнал.Продажи.КраткаяФорма");

ОткрытьФорму("Отчет", , "С:\lcv7db\extforms\profit.ert");



ОткрытьПодбор


Открыть форму для подбора значений.

Синтаксис:

ОткрытьПодбор(<ИмяОбъекта>, <ИмяФормы>, <КонтекстФормы>, <ФлагМножВыбора>,

              <ТекЗнач>)

Англоязычный синоним:

OpenPermanentChoice

Параметры:

<ИмяОбъекта>

Строковое выражение — имя объекта агрегатного типа, форму списка которого требуется открыть для подбора. Можно указывать справочник, жур­нал, документ (при указании документа открыва­ется форма журнала для указанного документа). Имя объекта задается в следующем виде:

"Справочник.ХХХХХ";

"Документ.ХХХХХ";

"Отчет.ХХХХХХ";

"Обработка.ХХХХХХ";

"Журнал.ХХХХХ" , где ХХХХХ — имя вида соответствующего объекта, как он задан в конфигураторе, например: "Справочник.Товары";

"Журнал.Подчиненные";

"ЖурналОпераций.ХХХХХ", где ХХХХХ — форма журнала пераций.

"ПланСчетов.ХХХХХ", где ХХХХХ — идентификатор плана счетов, как он за­дан в конфигураторе. Если ХХХХХ не за­дан, то открывается подбор из любого (всех) плана счетов.

<ИмяФормы>

Строковое выражение — имя формы подбора, как она задана в конфигураторе. Поскольку и справочники и журналы могут иметь несколько форм представления, то этим параметром можно конкретно указать, какая из форм представления объекта вызывается для подбора значений.

<КонтекстФормы>

Необязательный параметр. Имя переменной, куда можно задать значение любого типа для передачи в открываемую форму. Данное значение будет доступно в открытой форме как атрибут Форма.Параметр.

После исполнения данного метода система вер­нет в данную переменную контекст формы подбо­ра (см. «Передача контекста в качестве парамет­ра»). С помощью значения этого контекста можно затем произвольно манипулировать формой под­бора, пока она открыта. Пока форма открыта, тип значения данного параметра равен 100 (см. ТипЗначения), если закрыта — 0.

<ФлагМножВы6ора>

Необязательный параметр. Число: 1 — выбор не­скольких значений; 0 — выбор одного значения, после чего окно закрывается. Значение по умол­чанию: 1.

<ТекЗнач>

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



Описание:

Метод ОткрытьПодбор, который доступен только в контексте Модуля формы, выполняет открытие формы для подбора значений. Используется, на­пример, для подбора значения реквизита документа.

При открытии подбора по журналу подчиненных документов, т. е. когда первый параметр <ИмяОбъекта> имеет значение "Журнал.Подчиненные", документ владелец, по которому следует построить журнал подчиненных доку­ментов, передается после вызова метода через полученный контекст формы.

Пример:

Процедура Подбор()

   ГруппаДляВыбора = ТекущийЭлемент();

   Если ГруппаДляВыбора.ЭтоГруппа() = 0 Тогда

      ГруппаДляВыбора = ГруппаДляВыбора.Родитель;

   КонецЕсли;

   ОткрытьПодбор("Справочник.Товары", "ДляПодбора", КонтПодб, 0);

   // установим в форме подбора реквизит "ГруппаВыбора"

   // используя полученный контекст формы подбора

   КонтПодб.ГруппаВыбора.ВыборГруппы(1);

   КонтПодб.ГруппаВыбора = ГруппаДляВыбора;

   КонтПодб.Обновить(0);

   УстановитьЗначениеВПодборе("ГруппаВыбора", ГруппаДляВыбора);

КонецПроцедуры

См. также: ОбработкаПодбора, УстановитьЗначениеВПодборе


Отменить


Отменить запись изменения в базу.

Синтаксис:

Отменить()

Англоязычный синоним:

Cancel

Описание:

Метод Отменить отменяет запись изменения в базу (см. Автосохране­ние).

Пример:

см. пример метода Автосохранение



ОтменитьИсправление


Отменяет исправление записи журнала расчетов, сделанное ранее.

Синтаксис:

ОтменитьИсправление()

Англоязычный синоним:

UndoUpdate

Описание:

Отменяет исправление, сделанное ранее (вручную или из языка методом Исправить). Метод выполняет те же действие, что и интерактивная процедура отмены исправления записи журнала расчетов. Описание интерактивной про­цедуры отмены исправления результата записи журнала расчетов можно по­смотреть в книге «Руководство пользователя».



ОтменитьТранзакцию


Завершить транзакцию без записи изменений.

Синтаксис:

ОтменитьТранзакцию()

Англоязычный синоним:

RollBackTransaction

Описание:

Процедура ОтменитьТранзакцию завершает транзакцию без записи изме­нений.

Пример:

*

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

Процедура ЗагрузкаКурсовВалют()

   Влт = СоздатьОбъект("Справочник.Валюты");

   Текст = СоздатьОбъект("Текст");

   Текст.Открыть(ИмяФайла);

   Если Текст.КоличествоСтрок() = 0 Тогда

      Сообщить("Текст пустой!");

      Возврат;

   КонецЕсли;

   Успешно = 1;

   НачатьТранзакцию();

   Для Ном = 1 по Текст.КоличествоСтрок() Цикл

      Стр = Текст.ПолучитьСтроку(Ном);

      Если СтрДлина(Стр) = 0 Тогда

         Продолжить;

      КонецЕсли;

      Поле=0;

      Пока СтрДлина(Стр) > 0 Цикл

         Поле = Поле + 1;

         Инд = Найти(Стр, "-");

         Если Инд > 0 Тогда

            Если Инд > 3 Тогда

               Стр1 = Сред(Стр, 2, Инд-3);

               // не берем кавычки спереди и сзади, и символ тильды.

            Иначе

               // если значение поля пропущено

               Стр1 = "";

            КонецЕсли;

            Стр=Сред(Стр, Инд + 1);

            // не берем символ тильды

         Иначе

            Стр = Сред(Стр, 2);

            Инд = Найти(Стр, """");

            Стр1 = Сред(Стр, 1, Инд-1);

           Стр = "";

         КонецЕсли;

         Если Поле = 1 Тогда

            Код = Стр1;

         ИначеЕсли Поле = 2 Тогда

            Курс = Стр1;

         ИначеЕсли Поле = 3 Тогда

            ДатаКурса = Стр1;

         КонецЕсли;

      КонецЦикла;

      Влт.ИспользоватьДату(Дата(ДатаКурса));

      Влт.НайтиПоКоду(Код);

      Если Влт.Выбран() > 0 Тогда

         Сообщить(Формат(Ном, "45") + " - загрузка Курса="

              + Формат(Курс, "45") + " от " + ДатаКурса);

         Влт.Текущ_курс = Число(Курс);

         Влт.Записать();

         Сообщить("    – Загружен!");

      Иначе

         Успешно = 0;

         Сообщить("В базе данных нет валюты с кодом " + Код");

         Сообщить("Импорт данных отменён!");

         Прервать;

      КонецЕсли;

      Состояние("Загружено "+Ном+" строк.");

   КонецЦикла;

   Если Успешно = 1 Тогда

      ЗафиксироватьТранзакцию();

   Иначе

      ОтменитьТранзакцию();

   КонецЕсли;

КонецПроцедуры



ОтметитьЗначения


Открыть окно для интерактивной пометки значений списка.

Синтаксис:

ОтметитьЗначения(<Значение>, <3аголовок>, <Позиция>, <Таймаут>)

Англоязычный синоним:

CheckValues

Параметры:

<Значение>

Идентификатор переменной, куда помещается значение — результат выбора.

<Загoлoвoк>

Строковое выражение, значение которого отобра­жается в заголовке диалогового окна. Может ис­пользоваться для подсказки пользователю.

<Пoзиция>

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

<Tаймayт>

Необязательный параметр. Числовое выражение, значение которого задает время ожидания систе­мы (в секундах) на отклик пользователя.

Возвращаемое значение:

Число: 1 — если выбор произведен (нажата кнопка «ОК»); 0 — если выбоо не произведен (нажата кнопка «ОТМЕНА»); -1 (минус единица) — закончи­лось время <Таймаут> ожидания отклика пользователя.

Описание:

Метод ОтметитьЗначения вызывает диалоговое окно для интерактивной пометки значений списка из заранее подготовленного списка.

Возможность выбора значения — это дополнительная возможность, предос­тавляемая данным методом. Параметр <Значение> указывает на значение того элемента списка, на котором будет установлен курсор при открытии окна вы­бора. В этот же параметр возвращается последнее выбранное значение- В пара­метр <Позиция> возвращается номер позиции последнего выбранного значе­ния в списке. Если выбор отменен, то значение параметров не меняются.

Данный метод может использоваться только для переменных созданных функцией СоздатьОбъект.

Пример:

Функция ВыбратьКредит (ДокКредита)

   Перем ВыбДок;

   Список = СоздатьОбъект("СписокЗначений");

   Рег = СоздатьОбъект("Регистр.ТоварныйКредит");

   Рег.УстановитьФильтр(Клиент, );

   Рег.ВыбратьИтоги();

   Пока Рег.ПолучитьИтог() = 1 Цикл

      Док = Рег.Документ;

      Список. ДобавитьЗначение(Док, "" + Док + " — Остаток = " + Рег.Долг);

   КонецЦикла;

   Список.ОтметитьЗначения(ВыбДок, "Выберите кредиты");

   Возврат Список;

КонецФункции



ПанельИнструментов


Управление видимостью панели инструментов окна формы.

Синтаксис:

ПаяельИнструментов(<Режим>)

Англоязычный синоним:

ToolBar

Параметры:

<Режим>

Необязательный параметр. Числовое выражение: 1 — показать панель инструментов; 0 — не показы­вать панель инструментов. Если параметр не за­дан, то метод просто возвращает текущее состоя­ние видимости панели инструментов.

Возвращаемое значение:

Текущее состояние видимости панели инструментов окна формы.

Описание:

Метод ПанельИнструментов предоставляет возможность управления ви­димостью панели инструментов окна формы.

Доступ к данному методу возможен только в контексте Модуля формы.

Пример:

Форма.ПанельИнструментов(0);



данное данной форме при ее


Параметр, переданный при программном открытии формы.
Синтаксис:
Параметр
Англоязычный синоним:
Parameter
Описание:
Атрибут Параметр объекта «Форма» представляет собой значение, пере­ данное данной форме при ее открытии программно с помощью методов Открытьформу, ОткрытьФормуМодально, ОткрытьПодбор. Если форма открыта интерактивно или если параметр при программном открытии не передавался, то данный атрибут содержит значение неопределенного типа.
Доступ к данному атрибуту возможен только в контексте Модуля формы.
Пример:
ПереданныйПараметр = Форма.Параметр;
См. также: ОткрытьФорму, ОткрытьФормуМодально, ОткрытьПодбор

ПараметрыСтраницы


Установить параметры страницы.

Синтаксис:

ПараметрыСтраницы(<Ориентация>, <Масштаб>, <РежимПечатиКопий>, <ПолеСлева>,

                  <ПолеСправа>, <ПолеСверху>, <ПолеСнизу>, <КолонтитулСверху>,

                  <КолонтитулСнизу>, <Автомасштаб> , <ФлагЧерноБелойПечати>,

                  <ИмяПринтера>)

Англоязычный синоним:

PageSetup

Параметры:

<Ориентация>

Необязательный параметр. Числовое выражение — ориентация вывода на печать: 1 — портрет; 2 — ландшафт.

<Масштаб>

Необязательный параметр. Числовое выражение — масштаб (в процентах) вывода на печать.

<РежимПечатиКопий>

Необязательный параметр. Числовое выражение — режим вывода нескольких копий на печать: 0 — (collate) выводить сначала первые страницы всех копий, затем вторые и т. д.;1 — (разобрать) выводить страницы копий по порядку.

<ПолеСлева>

Необязательный параметр. Числовое выражение — расстояние (в миллиметрах) от правого края страницы.

<ПолеСверху>

Необязательный параметр. Числовое выражение — расстояние (в миллиметрах) от верхнего края страницы.

<ПолеСнизу>

Необязательный параметр. Числовое выражение — расстояние (в миллиметрах) от нижнего края страницы.

<КолонтитулСверху>

Необязательный параметр. Числовое выражение — размер (в миллиметрах) верхнего колонтиту­ла.

<КолонтитулСнизу>

Необязательный параметр. Числовое выражение — размер (в миллиметрах) нижнего колонтиту­ла.

<Автомасштаб>

Необязательный параметр. Числовое выражение — указывает режим автоматического подбора масштаба для размещения документа при печате на листе по ширине. 1 — Включить; 0 — Выклю­чить. По молчанию — 0.

<ФлагЧерноБелойПечати>

Необязательный параметр. Число: 1 — черно-белая печать; 0 — обычный режим печати. Зна­чение по умолчанию — 0.

<ИмяПринтера>

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

Описание:

Метод ПараметрыСтраницы позволяет установить параметры страницы вывода на печать.

Пример:

Таб.ПараметрыСтраницы(1, 100, 1, 17, 17, 25, 25, 10, 10);

См. также: Опции



Печать каталога товаров


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

//--------------------------------

Процедура ПечатьСправочника()

   // Процедура печати полного справочника товаров

   Перем Запрос, ТекстЗапроса, Таб;

   //Создание объекта типа Запрос

   Запрос = СоздатьОбъект("Запрос");

   ТекстЗапроса = "//{{ЗАПРОС(Печать)

   |Товар = Справочник.Товары.ТекущийЭлемент;

   |Группировка Товар Упорядочить по Товар.МинЗапас;

   |"//}}ЗАПРОС

   // Если ошибка в запросе, то выход из процедуры

   Если Запрос.Выполнить(ТекстЗапроса) = 0 Тогда

      Возврат;

   КонецЕсли;

   // Заполнение выходных форм данными запроса

   // Создание Таблицы для выходного отчета

   Таб = СоздатьОбъект("Таблица");

   Таб.ВывестиСекцию("Отчет");

   Пока Запрос.Группировка("Товар") = 1 Цикл

      // Заполнение полей Товар

      Если Запрос.Товар.ЭтоГруппа() = 1 Тогда

         Таб.ВывестиСекцию("Группа");

      Иначе

         Таб.ВывестиСекцию("Товар");

      КонецЕсли;

   КонецЦикла;

   //Отображение выходного отчета

   Таб.ТолькоПросмотр(1);

   Таб.Опции(0, 0, 4, 0);

   Таб.Показать("Список товаров по каталогу", "");

КонецПроцедуры



Передача локального контекста программного модуля в качестве параметра


В языке есть возможность передавать локальный контекст программного модуля (см. «Контекст выполнения программного модуля», «Виды программ­ных модулей») в качестве параметра процедуры или функции. Для этого в ка­честве фактического параметра при вызове процедуры или функции использу­ется ключевое слово Контекст (англоязычный синоним — Context). Данная возможность позволяет, например, написать в глобальном программном модуле процедуры и функции (общие для многих модулей), которые, при их вызове из других модулей, будут исполняться с использованием конкретного локального контекста вызвавшего модуля.

Пример:

Допустим, у нас есть несколько различных документов, причем у всех есть реквизит "Склад". В каждом программном модуле формы редактирования документа нужна процедура выбора склада. В глобальном программном модуле напишем процедуру:

Процедура УстСклада(Конт) Экспорт

   // создаем объект типа "справочник"

   Скл = СоздатьОбъект("Справочник.Склады");

   // вызываем диалог для выбора элемента Справочника

   Скл.Выбрать("Выберите Склад", "");

   Если Скл.Выбран() = 1 Тогда

      // если в диалоге элемент Справочника был выбран,

      // то присваиваем его значение реквизиту Документа,

      // который доступен по локальному контексту

      Конт.Склад = Скл.ТекущийЭлемент();

   КонецЕсли;

КонецПроцедуры

Здесь переменная Конт является формальным параметром, которому при вызове процедуры будет присвоен локальный контекст. В данном примере обращение к реквизитам и методам локального контекста происходит «че­рез точку» после идентификатора Конт, например:

Конт.Склад = Скл.ТекущийЭлемент();

Теперь в любом программном модуле конфигурации (в данном примере в любом Модуле формы документа) для выбора склада можно вызвать про­цедуру, передав ей свой локальный контекст в качестве параметра:

УстСклад(Контекст);



Передача параметров


По умолчанию параметры методов, процедур и функций передаются по ссылке, то есть изменение внутри процедуры или функции значения формаль­ного параметра ведет к изменению значения соответствующего фактического параметра. При передаче параметра по значению изменение значения формаль­ного параметра никак не влияет на фактический параметр вызова процедуры. Для указания того, что тот или иной параметр следует передавать по значению, следует в исходном тексте процедуры или функции перед именем параметра записать ключевое слово Знач (англоязычный синоним — Val).

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

Если параметру не задано значения по умолчанию, то при вызове процеду­ры его можно опускать в списке передаваемых фактических параметров, но разделительную запятую надо ставить.

Если параметр при вызове процедуры опущен, то он принимает либо уста­новленное по умолчанию значение (если оно есть) либо принимает «пустое» значение (значение неопределенного типа).

Если при вызове метода, процедуры или функции параметры не передаются (пустой список параметров), то, тем не менее, круглые скобки обязательно тре­буется ставить.

Пример:

Перем Глоб;

// Описание функции

Функция МояФункция(Знач Пар1, Пар2, Пар3) Экспорт

   Лок = Глоб + Пар1 + Пар2 + Пар3;

   Пар1 = 40;

   Возврат Лок;

КонецФункции

Глоб = 123;

А = 10;

Рез = МояФункция(А, 6, 7); // Вызов функции

// Здесь Рез = 146, а переменная А = 10, несмотря на то, что в теле

// функции значение параметра Пар1 изменено на 40



ПереименоватьФайл


Переименовать файл.

Синтаксис:

ПереименоватьФайл(<ИмяФайлаИсточника>, <ИмяФайлаПриемника>, <ФлагПерезаписи>)

Англоязычный синоним:

MoveFile

Параметры:

<ИмяФайлаИсточника>

Строковое выражение с именем файла ис­точника.

<ИмяФайлаПриемника>

Строковое выражение с требуемым именем файла.

<ФлагПерезаписи>

Числовое выражение: 0 — запрещает пере­мещение файла между дисками и при существовании файла приемника копирова­ния не производится; 1 — разрешает пере­мещение файла (только для файлов) между дисками и при существовании файла прием­ника замещает его на копируемый.

Описание:

Метод ПереименоватьФайл выполняет переименование (перемещение) указанного файла.

Пример:

* В данном примере приведена процедура переименования файла.

Процедура ПереимФ()

   ФС.ПереименоватьФайл(Результат, ФПриемник, 1);

КонецПроцедуры



Переиндексировать


Переиндексировать базу.

Синтаксис:

Переиндексировать()

Англоязычный синоним:

Reindex

Описание:

Метод Переиндексировать выполняет переиндексирование базы. Объек­ты XBase автоматически выполняют индексацию при изменениях базы данных, однако, при работе более чем с одним индексным файлом или после аварийных завершений может потребоваться принудительная переиндексация (для «сво­их» БД система 1С:Предприятие выполняет это автоматически).

Пример:

Процедура ПерИндДБ()

   Если ФлагАварийногоЗавершения = 1 Тогда

      ДБФ.Переиндексировать();

   КонецЕсли;

КонецПроцедуры



Перейти


Перейти на запись по ее номеру записи.

Синтаксис:

Перейти(<НомерЗаписи>)

Англоязычный синоним:

GoTo

Параметры:

<НомерЗаписи>

Числовое выражение — физический порядковый номер записи в базе данных.

Описание:

Метод Перейти позволяет перейти на запись по ее физическому порядко­вому номеру в базе данных. Позволяет перейти на запись, помеченную удален­ной, даже если не установлен режим просмотра удаленных записей.

Пример:

Процедура ИнформацияОЗаписи(НЗап)

   ДБФ.Перейти(НЗап);

   Стр3ап = "н." + ДБФ.НомерЗаписи();

   Стр3ап = Стр3ап + " Уд. " + ДБФ.ЗаписьУдалена();

   Стр3ап = СтрЗап + " Содержит -";

   Для КП = 1 По ДБФ.КоличествоПолей() Цикл

      СтрЗап = СтрЗап + Строка(ДБФ.ПолучитьЗначениеПоля(КП)) + "; ";

   КонецЦикла;

   Предупреждение(СтрЗап, 10);

КонецПроцедуры

См. также: НомерЗаписи



Перейти


Безусловная передача управления на другой оператор программы.

Синтаксис:

Перейти <Метка>;

Англоязычный синоним:

Goto

Параметры:

<Метка>

Метка другого исполняемого оператора в программе.

Описание:

Безусловная передача управления на другой оператор программы. Оператор Перейти передает управление от одного оператора к другому. <Метка> в этом операторе не должна быть меткой перехода на оператор Процедура или Функция.

Область действия оператора Перейти ограничивается программным моду­лем, процедурой или функцией; он не может передать управление за пределы программного модуля, процедуры или функции.

Оператор безусловного перехода не может быть использован для передачи управления на операторы, находящиеся внутри конструкций: Пока ... КонецЦикла, Для ... КонецЦикла, Если ... ИначеЕсли ... Иначе ... КонецЕсли, Попытка ... Исключение ... КонецПопытки извне этих конструкций.

Пример:

     // Выведем строки текста

     Выв = СоздатьОбъект("Текст");

     Выв.Открыть("ТТТ");

     Для i = l По Выв.КоличествоСтрок() Цикл

        Если i = 10 Тогда

           Перейти ~М1;

        КонецЕсли;

        Сообщить(Выв.ПолучитьСтроку(i));

        Перейти ~М2;

~М1:    Сообщить("Это десятая строка");

~М2: КонецЦикла;



Перем


Объявление переменной в явном виде.

Синтаксис:

Перем <Имя_переменной> [[<Размерность>]] [Экспорт];

Англоязычный синоним:

Var:

Параметры

<Имя_переменной>

Имя переменной.

[<Размерность>]

Необязательная числовая константа (записывает­ся в квадратных скобках), указывается только в том случае, если объявляется массив и должна представляться в виде положительного целого числа.

Экспорт

Необязательное ключевое слово Экспорт указы­вает, что данная переменная станет доступна для других модулей. Использование данного ключево­го слова имеет смысл только в глобальном про­граммном модуле.

Описание:

Оператор Перем в явном виде объявляет переменную.

Пример:

Перем Очень_Нужная_Переменная;

Перем Массив_Для_Хранения[10];



Перерасчет


Признак того, что запись является перерасчетом другой записи про­шлого периода.

Синтаксис:

Перерасчет

Англоязычный синоним:

Recalc

Описание:

Атрибут типа «число», принимает два значения: 1 — для записей-перерасчетов и 0 — для остальных записей.

Записи-перерасчеты вводятся в журнал расчетов при выполнении одного из методов журнала расчетов: ВвестиПерерасчет или ВвестиПерерасчетНаОсновании.

Атрибут Перерасчет предназначен только для чтения.

Пример:

ЖрнЗарплата = СоздатьОбъект("ЖурналРасчетов.Зарплата");

ЖрнЗарплата.ВыбратьПериодПоОбъекту(Сотрудник, ДатаОтчета);

Есть = 0;

Пока ЖрнЗарплата.ПолучитьЗапись() = 1 Цикл

   Если ЖрнЗарплата.Перерасчет = 0 Тогда

      Есть = 1;

      Пер = ЖрнЗарплата.ПервичнаяЗапись.ПериодРегистрации;

      Прервать;

   КонецЕсли;

КонецЦикла;

Если Есть = 1 Тогда

   Предупреждение("За истекший период проводились перерасчеты

          | прошлого периода " + Пер.Описатель);

   Возврат;

КонецЕсли;

// продолжим формирование документа

См. также: ПервичнаяЗапись



Период С


Установить временной интервал дат формирования запроса.

Синтаксис:

[[Период] С <Дата>|<ВнешняяПерем> [ПО <Дата>|<ВнешПеременная>];]

Англоязычный синоним:

[[Period] From <Дата>|<ВнешПеременная> [Till <Дата> | <ВнешПеременная>];]

Параметры:

<Дата>

Константа типа «Дата», «Документ» или . позиция документа.

<ВнешПеременная>

Внешняя переменная типа «Дата», «Доку­мент» или позиция документа. Если указан документ, то за момент времени принима­ется дата и время документа.

По

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

Описание:

Оператор Период С устанавливает интервал дат формирования запроса. Если в описании запроса оператор Период С опущен, то интервал дат форми­рования запроса устанавливается в точку актуальности

итогов (ТА) (или на РабочуюДату, если не установлена компонента «Оперативный учет»), запрос формируется только на этот момент времени.

Использование данного оператора актуально только в том случае, если за­прос строится для выборки данных по регистрам, журналам расчетов и/или документам. Здесь указывается, в каком интервале выбирать движения регист­ров и/или подборку документов. При выполнении запроса только по справоч­никам эта секция не играет никакой роли.

Параметрами оператора Период С являются значения момента времени («Дата», «Документ» или позиция документа) начала и конца временного ин­тервала. Следует особо обратить внимание, что если интервал задается с точно­стью до даты, то интервал времени считается от начала даты нижней границы интервала до конца даты верхней границы интервала. Если вторая часть опера­тора после ключевого слова По пропущена или значение второго параметра команды равно нулю, то интервал времени применяется от начального момента времени до ТА (или по РабочуюДату, если не установлена компонента «Опе­ративный учет»). Это особенно важно при формировании запросов по регист­рам, т. к. запрос по регистрам может строиться от любой даты в прошлом до ТА. Поэтому, если вы укажете в запросе верхнюю границу интервала большей или равной дате ТА, то программа скорее всего сообщит «Не могу рассчитать регистры за ТА» (поскольку время ТА лежит где то в пределах даты, а запрос пыта­ется учесть всю дату в целом). Поэтому при формировании текста запроса следует вставлять дополнительную проверку типа той, что приведена в следу ющем примере:




Пример:

Запрос = СоздатьОбъект("Запрос");

ТекстЗапроса =

"Счет = Регистр.Cash.Счет;

|Статья = Регистр.Cash.Статья;

|СуммаЭквивалента2 = Регистр.Cash.СуммаЭквивалента2;

|СуммаЭквивалента1 = Регистр.Cash.СуммаЭквивалента1;

......

Если ДатаКонца >= ПолучитьДатуТА() Тогда

   ТекстЗапроса = ТекстЗапроса + "Период с ДатаНачала;";

Иначе

   ТекстЗапроса = ТекстЗапроса + "Период с ДатаНачала по ДатаКонца;";

КонецЕсли;

Если Запрос.Выполнить(ТекстЗапроса) = 0 Тогда

   Возврат;

КонецЕсли;

Работа команды при формировании запросов к журналам расчетов зависит от того, используется ключевое слово "Период" или нет. Применение конст­рукции "Период С ... По..." приводит к тому, что выборка записей из журнала расчетов осуществляется в разрезе расчетных периодов конкретного журнала, фактически, по времени ввода строк журнала расчетов в систему.

Применение конструкции "С ... По ..." приводит к тому, что выборка записей из журнала расчетов проводится по времени действия записей журнала расчетов, определяемых реквизитами журнала расчетов "ДатаНачала" и "ДатаОкончания", а не временем их ввода в журнал. Более подробно о двойст­венности временного представления журналов расчетов см. выше, в главе «Ра­бота с Журналами расчетов».

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

Пример:

*

Процедура РасчЛистки()

   Перем Запрос, Флаг;

   Перем ДатаНач, ДатаКон;

   ЖР = СоздатьОбъект{"ЖурналРасчетов.Зарплата");

   Нач = ЖР.НачалоТекущегоПериода();

   Кон = ЖР.КонецТекущегоПериода();

   //Создание объекта типа Запрос

   Запрос = СоздатьОбъект("Запрос");



   Флаг = Запрос.Выполнить(

   "//{{ЗАПРОС(РасчЛистки)

   |Период С ДатаНач По ДатаКон; // выборка по расчетным периодам!

   |Рез = ЖурналРасчетов.Зарплата.Результат;

   |Расч = ЖурналРасчетов.Зарплата.ВидРасч;

   |Дни = ЖурналРасчетов.Зарплата.Дни;

   |Сотр = ЖурналРасчетов.Зарплата.Объект;

   |Группировка Сотр без групп;

   |Группировка Расч;

   |функция Сум = Сумма(Рез);

   |функция Дней = Сумма(Дни);

   |Условие(Рез о 0);

   |"//}}ЗАПРОС

   );

   // ...

КонецПроцедуры;

*

//Создание объекта типа Запрос

Запрос = СоздатьОбъект("Запрос");

// ниже формируется текст запроса с выборкой по времени

// действия записей журнала расчетов, а не по расчетным периодам!

ТекстЗапроса =

"//{{ЗАПРОС(Сформировать)

|С ДатаНач По ДатаКон;

|Рез = ЖурналРасчетов.Зарплата.Результат;

|Сотр = ЖурналРасчетов.Зарплата.Объект;

|ПЖ = ЖурналРасчетов.Зарплата.ПериодРегистрации;

|Группировка Сотр без групп;

|Группировка ПЖ;

|Функция Сум = Сумма(Рез);

"//}}ЗАПРОС

;

Флаг = Запрос.Выполнить(ТекстЗапроса);

// ...


ПериодД


Устанавливает произвольный период в качестве периода расчета ито­гов.

Синтаксис:

ПериодД(<ДатаНачалаПериода>, <ДатаКонцаПериода>)

Англоязычный синоним:

PeriodD

Параметры:

<ДатаНачалаПериода>

Необязательный параметр. Начальная дата периода выдачи итогов.

<ДатаКонцаПериода>

Необязательный параметр. Конечная дата пе­риода выдачи итогов.

Описание:

Метод ПериодД задает период расчета итогов для функций режима основ­ных итогов.

Период, установленный методом ПериодД, действует до конца вызова дру­гого метода установки периода для этого объекта.

Если параметры не заданы — значения периода берется из периода, заданно­го пользователем интерактивно в меню «Сервис»-«Параметры»-«Бухгалтерские итоги».

Пример:

БухИтоги.ПериодД('07.01.98', '17.01.98');



ПериодДействия


Период действия записи журнала расчетов.

Синтаксис:

ПериодДействия

Англоязычный синоним:

EffectivePeriod

Описание:

Атрибут типа «период журнала расчетов» — период действия текущей запи­си журнала расчетов. Под периодом действия подразумевается тот расчетный период журнала, в который попадают ДатаНачала и ДатаОкончания дейст­вия записи журнала расчетов (акта расчета).

Атрибут ПериодДействия предназначен только для чтения.

Пример:

Процедура ПоПодр()

   Перем Запрос, ТекстЗапроса, Таб;

   //Создание объекта типа Запрос

   Запрос = СоздатьОбъект("Запрос");

   ТекстЗапроса = "//{{ЗАПРОС(ПоПодр)

   |Период с ДатаНач по ДатаКон;

   |Док = ЖурналРасчетов.Зарплата.ТекущийДокумент;

   |ПД = ЖурналРасчетов.Зарплата.ПериодДействия;

   |Подр = ЖурналРасчетов.Зарплата.Объект.МестоРаботы.Владелец;

   |Рез = ЖурналРасчетов.Зарплата.Результат;

   |Группировка ПД;

   |Группировка Подр без групп;

   |Функция Итог = Сумма(Рез);

   |"//}}ЗАПРОС

   // Если ошибка в запросе, то выход из процедуры

   Если Запрос.Выполнить(ТекстЗапроса) = 0 Тогда

      Возврат;

   КонецЕсли;

   // Подготовка к заполнению выходных форм данными запроса

   Таб = СоздатьОбъект("Таблица");

   Таб.ИсходнаяТаблица("ПоПодр");

   // Заполнение полей "Заголовок"

   Таб.ВывестиСекцию("Заголовок");

   Пока Запрос.Группировка("ПД") = 1 Цикл

      // Заполнение полей ПД

      Таб.ВывестиСекцию("ПД");

      Сообщение(Запрос.ПД.Описатель);

      Пока Запрос.Группировка("Подр") = 1 Цикл

         // Заполнение полей Подр

         Таб.ВывестиСекцию("Подр");

      КонецЦикла;

   КонецЦикла;

   // Заполнение полей "Итого"

   Таб.ВывестиСекцию("Итого");

   // Вывод заполненной формы

   Таб.Опции(1, 0, 1, 0);

   Таб.Показать("ПоПодр", "");

КонецПроцедуры

См. также: ДатаНачала, ПериодДействия, ПериодРегистрации



ПериодКВ


Устанавливает квартал в качестве периода расчета итогов.

Синтаксис:

ПериодКВ(<Дата>|<НомерКвартала>, <Год>)

Англоязычный синоним:

PeriodQ

Параметры:

<Дата>

Дата — любая дата из квартала, устанавливаемого в качестве периода расчета итогов.

<НомерКвартала>

Число от 1 до 4 — порядковый номер квартала.

<Год>

Год заданный числом (включая век). Используется только, если первый параметр — номер квартала.

Описание:

Метод ПериодКВ задает период расчета итогов для функций режима основ­ных итогов. В качестве параметра метода может передаваться либо дата, лежа­щая в том квартале, который будет назачен в качестве периода рачета итогов, либо номер квартал — цифра от 1 до 4. Номер квартала задает квартал года, указанного вторым параметром.

Период, установленный методом ПериодКВ, действует до вызова другго ме­тода установки периода.

Пример:

БухИтоги.ПериодКВ('07.01.98');



ПериодКВН


Устанавливает в качестве периода расчета итогов период с начала го­да до конца указанного квартала.

Синтаксис:

ПериодКВН(<Дата>|<НомерКвартала>, <Год>)

Англоязычный синоним:

PeriodQAccumY

Параметры:

<Дата>

Дата — любая дата квартала, устанавливаемого в качестве периода расчета итогов.

<НомерКвартала>

Число от 1 до 4 — порядковый номер квартала.

<Год>

Год заданный числом (включая век). Используется только, если первый параметр — номер квартала.

Описание:

Метод ПериодКВН задает период расчета итогов для функций режима ос­новных итогов. В качестве периода расчета итогов метод устанавливает период с начала года до конца квартала, задаваемого параметрами.

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

Периодом расчета итогов считается период с начала года до конца указан­ного квартала.

Период, установленный методом ПериодКВН, действует до вызова другого метода установки периода.

Пример:

БухИтоги.ПериодКВН('07.01.98');



ПериодМ


Устанавливает в качестве периода расчета итогов месяц.

Синтаксис:

ПериодМ(<Дата>|<НомерМесяца>, <Год>)

Англоязычный синоним:

PeriodM()

Параметры:

<Дата>

Дата — любая дата из месяца, устанавливаемого в качестве периода расчета итогов.

<НомерМесяца>

Число от 1 до 12 — порядковый номер месяца.

<Год>

Год заданный числом (включая век). Использует­ся только, если первый параметр — номер месяца.

Описание:

Метод ПериодМ задает период расчета итогов для функций режима основ­ных итогов. В качестве параметра метода может передаваться либо дата месяца, который будет назначен в качестве периода рачета итогов, либо номер месяца — число от 1 до 12. Номер месяца задет месяц года переданного в качестве второ­го пареметра.

Период, установленный методом ПериодМ, действует до вызова другого ме­тода установки периода.

Пример:

БухИтоги.ПериодМ('07.01.98');



ПериодМНГ


Устанавливает в качестве периода расчета итогов период с начала го­да до конца указанного месяца.

Синтаксис:

ПериодМНГ(<Дата>|<НомерМесяца>, <Год>}

Англоязычный синоним:

PeriodMAccumY

Параметры:

<Дата>

Дата — любая дата месяца, устанавливаемого в качестве периода расчета итогов.

<НомерМесяца>

Число от 1 до 12 — порядковый номер месяца.

<Год>

Год заданный числом (включая век). Использует­ся только, если первый параметр — номер месяца.

Описание:

Метод ПериодМНГ задает период расчета итогов для функций режима ос­новных итогов. В качестве периода расчета итогов функция устанавливает пе­риод с начала года до конца месяца, задаваемого параметрами.

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

Периодом расчета итогов считается период с начала года до конца указан­ного месяца.

Период, установленный функцией ПериодМНГ, действует до вызова другой функции установки периода.

Пример:

БухИтоги.ПериодМНГ('07.08.98');



ПериодМНК


Устанавливает в качестве периода расчета итогов период с начала квартала до конца указанного месяца.

Синтаксис:

ПериодМНК(<Дата>|<НомерМесяца>, <Год>)

Англоязычный синоним:

PeriodMAccumQ

Параметры:

<Дата>

Дата — любая дата месяца, устанавливаемого в качестве периода расчета итогов.

<НомерМесяца>

Число от 1 до 12 — порядковый номер месяца.

<Год>

Год заданный числом (включая век). Использует­ся только, если первый параметр — номер месяца.

Описание:

Метод ПериодМНК задает период расчета итогов для функций режима ос­новных итогов. В качестве периода расчета итогов метод устанавливает период с начала квартала до конца месяца, задаваемого параметрами.

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

Периодом расчета итогов считается период с начала квартала до конца ука­занного месяца.

Период, установленный методом ПериодМНК, действует до вызова другой функции установки периода.

Пример:

БухИтоги.ПериодМНК('07.08.98');



ПериодПоДате


Возвращает период журнала расчетов по дате.

Синтаксис:

ПериодПоДате(<Дата>)

Англоязычный синоним:

PeriodByDate

Параметры:

<Дата>

Значение типа «дата».

Возвращаемое значение:

Период журнала расчетов.

Описание:

Метод ПериодПоДате возвращает период журнала расчетов по дате — т. е. период, в который попадает заданная дата.

Пример:

ЖР = СоздатьОбъект("ЖурналРасчетов.Зарплата");

Пер = ЖР.ПериодПоДате(РабочаяДата());

См. также: НачалоТекущегоПериода, ПериодДействия, ПериодРегистрации, КонецПериодаПоДате



ПериодРегистрации


Период регистрации записи журнала расчетов.

Синтаксис:

ПериодРегистрации

Англоязычный синоним:

RegistrationPeriod

Описание:

Атрибут типа «период журнала расчетов» — расчетный период, в котором текущая запись была введена в журнал расчетов. Это тот расчетный период, который на момент ввода данной записи был установлен для журнала расчетов как текущий.

Атрибут ПериодРегистрации предназначен только для чтения.

Пример:

См. предыдущий пример.

См. также: ДатаНачала, ДатаОкончания, ПериодДействия



ПериодСтр


Строковое представление периода.

Синтаксис:

ПериодСтр(<ДатаНачалаПериода>, <ДатаКонцаПериода>)

Англоязычный синоним:

Рег1odStr

Параметры:

<ДатаНачалаПериода>

Дата — начальная дата периода.

<ДатаКонцаПериода>

Дата — конечная дата периода.

Возвращаемое значение:

Символьная строка — представление периода.

Описание:

Внутри системы все периоды задаются интервалом дат — дата начала и дата конца. Функция ПериодСтр предназначена для того, чтобы в случае, если пе­риод фактически является кварталом, месяцем, полугодием отобразить его со­ответствующим образом, например "1 квартал 1997 г".

Функция ПериодСтр возвращает информацию о периоде бухгалтерских итогов в виде строки символов. Строка может использоваться для выдачи ин-форации о периоде итогов в отчетах.

Пример:

Дата1='01.01.97';

Дата2='31.03.97';

Сообщить(ПериодСтр(Дата1, Дата2));  //Выводит "1 квартал 1997 г."



Первая


Перейти на первую запись.

Синтаксис:

Первая()

Англоязычный синоним:

First

Возвращаемое значение:

Число: 1 — если действие выполнено; 0 — если действие не выполнено.

Описание:

Метод Первая предназначен для перехода на первую запись. Если не уста­новлен текущий индекс, объект позиционируется на первую запись в базе дан­ных, если установлен — на запись, имеющую самое младшее значение выраже­ния текущего индекса (если индекс создавался с установленным флагом «Убы­вание», то наоборот).

Пример:

// Обнуляет значения всех полей первой записи

Процедура ОчистПервуюЗап()

   ДБФ.Первая();

   ДБФ.Очистить();

   ДБФ.Записать();

КонецПроцедуры



ПервичнаяЗапись


Первичная запись записи-перерасчета. Запись, на основании которой введена текущая запись-перерасчет.

Синтаксис:

ПервичнаяЗапись

Англоязычный синоним:

ParentRecord

Описание:

Атрибут типа «запись журнала расчетов». Имеет непустое значение для за­писей-перерасчетов, т. е. тех записей, которые введены в систему одним из ме­тодов журнала расчетов: ВвестиПерерасчет или ВвестиПерерасчетНаОсновании.

Атрибут ПервичнаяЗапись предназначен только для чтения.

Пример:

См. предыдущий пример.

См. также: Перерасчет, ВвестиПерерасчет, ВвестиПерерасчетНаОсновании



ПланСчетов


Выдает план счетов, которому принадлежит счет.

Синтаксис:

ПланСчетов()

Англоязычный синоним:

ChartOfAccounts

Возвращаемое значение:

Значение типа «План счетов».

Описание:

Метод выдает план счетов (значение типа «План счетов»), которому при­надлежит счет.

Пример:

Сч = СоздатьОбъект("Счет.Основной");

Сч.НайтиПоКоду("76.02");

Сообщить("План счетов - " + Сч.ПланСчетов());

// Выдает "План счетов - Основной"



ПланСчетов


Выдает план счетов текущей проводки.

Синтаксис:

ПланСчетов()

Англоязычный синоним:

ChartOfAccounts

Возвращаемое значение:

Значение типа «План Счетов».

Описание:

Для текущей проводки возвращает ее план счетов.

Пример:

Опер = СоздатьОбъект("Операция");

Опер.НайтиОперацию(ВыбрДокумент);

Для Инд = 1 До Опер.КоличествоПроводок() Цикл

   Опер.ПолучитьПроводкуПоНомеру(Инд);

   Сообщить("Проводка " + Опер.НомерПроводки() + "Корр. " +

            Опер.НомерКорреспонденции() + "Пл.сч." + Опер.ПланСчетов());

КонецЦикла;



ПланыСчетов


Атрибут глобального контекста для получения существующих значе­ний типа «ПланСчетов».

Синтаксис:

ПланыСчетов

Англоязычный синоним:

Charts0fAccounts

Описание:

Атрибут ПланыСчетов не имеет самостоятельного смысла, а служит для получения конкретных значений типа «ПланСчетов». Атрибут всегда использу­ется с доступными ему атрибутами и методами.

Атрибуты и методы:

Для получения конкретного значения типа «План счетов» следует через точку указать атрибут — идентификатор плана счетов.

Для получения количества существующих в конфигурации планов счетов следует через точку вызвать метод КоличествоЗначений.

Для получения значения типа «План счетов» по его номеру в метаданных, следует через точку вызвать метод ЗначениеПоНомеру(<Число>), где <Число> — номер плана счетов в метаданных.

Пример:

Сч = СоздатьОбъект("Счет");

// ...

Если Сч.ПланСчетов() = ПланыСчетов.РабПлан Тогда

   // ...

КонецЕсли;

Для Инд = 1 По ПланыСчетов.КоличествоЗначений() Цикл

   ПлСч = ПланыСчетов.ЗначениеПоНомеру(Инд);

КонецЦикла;



Подчеркнутый


Получить/установить признак подчеркнутого шрифта области.

Синтаксис:

Подчеркнутый(<Подчеркнутый>)

Англоязычный синоним:

Underline

Параметры:

<Подчеркнутый>

Необязательный параметр. Число: 1 — шрифт под­черкнутый; 0 — шрифт не подчеркнутый. Если па­раметр опущен, то признак подчеркнутого шрифта области не изменяется.

Возвращаемое значение:

Признак подчеркнутого шрифта до исполнения метода.

Описание:

Метод Подчеркнутый устанавливает признак подчеркнутого шрифта об­ласти.

Пример:

Таб = СоздатьОбъект("Таблица");

Таб.Открыть("tabl_l.mxl");

ВыбОбласть = Таб.Область("R8C4");

ВыбОбласть.Шрифт("Arial");

ВыбОбласть.РазмерШрифта(10);

ВыбОбласть.Подчеркнутый(1);



ПодчинениеДокументу


Установить документ-владелец для журнала подчиненных документов.

Синтаксис:

ПодчинениеДокументу([<Докум>], [<ФлагАвтоСменыПодчинен>])

Англоязычный синоним:

ParentDoc

Параметры:

<Докум>

Необязательный параметр. Выражение типа «документ» — значение документа, подчиненные документы к которому дол­жен отображать журнал.

<флагАвтоСменыПодчинен>

Необязательный параметр. Числовое вы­ражение: 1 — устанавливает способность автоматически обновлять отображение журнала при смене документа-владельца, если такой режим установлен в параметрах системы («Сервис» - «Один журнал»); 0 — снятие режима автоматического обновле­ния отображения журнала.

Возвращаемое значение:

Текущее значение документа, которому подчинен журнал.

Описание:

Метод ПодчинениеДокументу позволяет установить документ-владелец для журнала подчиненных документов.

Данный метод доступен только в контексте Модуля формы журнала подчи­ненных документов (см. «Виды программных модулей»).

Пример:

ПодчинениеДокументу(Док, 1);



Пока


Оператор выполнения цикла.

Синтаксис:

Пока <Логическое_выражение> Цикл

   //операторы;

КонецЦикла;

Англоязычный Синтаксис:

While <Логическое_выражение> Do

   //операторы;

EndDo;

Параметры:

<Логическое_выражение>

Логическое выражение.

Цикл

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

//операторы;

Исполняемый оператор или последова­тельность таких операторов.

КонецЦикла

Ключевое слово, которое завершает структуру оператора цикла.

Описание:

Оператор цикла Пока предназначен для циклического повторения операто­ров, находящиеся внутри конструкции Цикл ... КонецЦикла. Цикл выполняет­ся пока логическое выражение

— истина. Условие выполнения цикла все­гда проверяется вначале, перед выполнением цикла.

Пример:

Док = СоздатьОбъект("Документ.БригадныйНаряд");

// Будем просматривать документы в интервале дат

Док.ВыбратьДокументы('11.01.88', '11.01.99');

// Цикл по всем Документам

Пока (Док.ПолучитьДокумент() = 1) Цикл

   // отобразим Документ в строке состояния

   Состояние(Док.Вид() + " " + Док.НомерДок + " " + Док.ДатаДок);

   Док.ВыбратьСтроки();

   // вложенный цикл по всем строкам Документа

   Пока(Док.ПолучитьСтроку() > 0) Цикл

      Если Док.КодРабот = 104 Тогда

         Сообщить(" " + Док.НомерДок);

      КонецЕсли;

   КонецЦикла;

КонецЦикла;



Показать


Открыть окно табличного документа.

Синтаксис:

Показать([<3аголовок>], [<ИмяФайла>], [<Активизировать>])

Англоязычный синоним:

Show

Параметры:

<Заголовок>

Необязательный параметр. Строковое выраже­ние — заголовок окна табличного документа.

<ИмяФайла>

Необязательный параметр. Строковое выраже­ние — имя файла для сохранения табличного до­кумента.

<Активизировать>

Необязательный параметр. Числовое выраже­ние — признак активизации. Может принимать значения:

1 — активизировать окно табличного документа;

0 — не активизировать окно табличного докумен­та;

-1 (минус единица) — закрыть окно если оно открыто.

Значение по умолчанию: 1.

Описание:

Метод Показать открывает окно с табличным документом для просмотра и редактирования.

Параметр <Заголовок> позволяет задать заголовок окна, содержащего табличнй документ. Если параметр не указан, в заголовке будет выдаваться слово «Таблица».

Если указан параметр <ИмяФайла>, то при закрытии окна табличного до­кумента система 1С:Предприятие будет предлагать сохранить документ в файл с указанным именем. Если файла с именем <ИмяФайла> не существует, будет создан новый файл с таким именем.

Если параметр <ИмяФайла> опущен или имеет пустое значение, то при за­крытии окна табличного документа система 1С:Предприятие не будет предла­гать сохранить данные в файл. Это имеет смысл для документов, которые фор­мируются только для просмотра или печати, и их не обязательно записывать в файл. Вместе с этим, пользователь в любом случае может записать табличный документ в файл, используя команды «Сохранить» и «Сохранить как» из меню «Файл» главного меню системы 1С:Предприятие.

Параметр <Активизировать> позволяет регулировать активизацию окна табличного документа при вызове метода Показать. Если значение параметра — 0 , то окно открывается, но не становится активным.

Пример:

* Создается объект типа «Таблица» для работы с табличными документами, Открывается табличный документ, находящийся в файле SRC.MOX .

// Для работы с табличными документами создаем

// объект типа "Таблица"

Таб = СоздатьОбъект("Таблица");

// Открываем табличный документ из файла

Таб.Открыть("\v7\db\src.mox");

// Показ табличного документа

Таб.Показать();



Показать


Открыть окно редактирования текста.

Синтаксис:

Показать(<3аголовок>, <ИмяФайла>)

Англоязычный синоним:

Show

Параметры:

<Заголовок>

Заголовок окна редактирования.

<ИмяФайла>

Строковое выражение с именем файла.

Описание:

Метод Показать открывает окно с текстом для редактирования и про­смотра. Если параметр <ИмяФайла> имеет непустое значение, то при закрытии окна система будет предлагать сохранить данные в указанный файл. Если файла с именем <ИмяФайла> не существует, то будет создан новый файл с таким именем для сохранения текста. Если параметр <ИмяФайла> опущен или имеет пустое значение, то при закрытии окна система не будет предлагать сохранить данные в файл. Это имеет смысл для текстовых документов, которые форми­руются только для просмотра или печати, и их не обязательно записывать в файл. Разумеется, после открытия окна пользователь в любом случае может записать такой текст в файл, используя команды главного меню «Файл».

Пример:

ТекстДок = СоздатьОбъект("Текст");

ТекстДок.Открыть("catalog.txt");

ТекстДок.Показать("Редактирование Прайс-листа", "catalog.txt");



ПоказыватьУдаленные


Установить режим показа удаленных записей в базе.

Синтаксис:

ПоказыватьУдаленные(<Режим>)

Англоязычный синоним:

ShowDeleted

Параметры:

<Режим>

Необязательный параметр. Числовое выражение: 1 — установить режим показа удаленных записей в базе. 0 — снять режим.

Возвращаемое значение:

Текущее числовое значение режима показа удаленных записей в базе (на момент до исполнения метода).

Описание:

Метод ПоказыватьУдаленные позволяет определить и изменить режим показа удаленных записей в базе. В случае, если параметр не указан, изменения режима не происходит.

Пример:

Процедура ПоказатьНомераУдалЗап()

   РежПокУд = ДБФ.ПоказыватьУдаленные(1);

   ДБФ.Первая();

   Пока ДБФ.ВКонце() = 0 Цикл

      Если ДБФ.ЗаписьУдалена() = 1 Тогда

         Предупреждение("Номер удаленной записи — " +

                         Строка(ДБФ.НомерЗаписи()), 3);

      КонецЕсли;

      Если ДБФ.Следующая() = 0 Тогда

         Прервать;

      КонецЕсли;

   КонецЦикла;

   ДБФ.ПоказыватьУдаленные(РежПокУд);

КонецПроцедуры

См. также: Удалить, Восстановить