Методы контекста Модуля формы элемента справочника
Описанные в данном разделе методы доступны только в контексте Модуля формы элемента справочника (см. «Виды программных модулей»).
Методы контекста Модуля формы списка счетов
Описанные в данном разделе методы доступны только в контексте Модуля формы списка счетов (см. «Виды программных модулей»).
Методы контекста Модуля формы списка справочника
Описанные в данном разделе методы доступны только в контексте Модуля формы списка справочника (см. «Виды программных модулей»).
Методы контекста Модуля формы журнала документов
Описанные в данном разделе методы доступны только в контексте Модуля формы журнала документов (см. «Виды программных модулей»).
Отбор по значениям может производиться только в «Общем» журнале, т. е. в котором установлен признак «Все документы». Таким образом, отбор по значениям может выступать в качестве альтернативного способа выбора документов в журнале, относительно выбору документов по видам. С другой стороны, сам набор ссылок на реквизиты документов определенных видов в настройке графы отбора определяет состав видов документов включаемых в данный отбор. Для того, чтобы при открытии журнала не показывался список всех документов, следует в предопределенной процедуре ПриОткрытии установить отбор по несуществующему значению отбора, например, по пустому значению.
Методы контекста Модуля формы журнала операций
Описанные в данном разделе методы доступны только в контексте модуля формы журнала операций (см. «Виды программных модулей»).
Методы контекста Модуля формы журнала проводок
Описанные в данном разделе методы доступны только в контексте модуля формы журнала проводок (см. «Виды программных модулей»).
Методы контекста Модуля формы журнала расчетов
Описанные в данном разделе методы доступны только в контексте Модуля формы журнала расчетов (см. «Виды программных модулей»).
Методы объекта Форма
При помощи объекта «Форма» предоставляется возможность управлять визуальным представлением текущей формы, опрашивать текущее состояние режима работы формы и т. п.
Методы оборотных регистров
Описанные в данном разделе методы используются только для оборотных регистров.
Методы работы с метаданными
Перечень методов метаданных предназначенных для доступа к подчиненным объектам метаданных можно получить, сформировав в конфигураторе текстовый файл «Описание структуры метаданных».
Дополнительные методы работы с метаданными приведены ниже.
Методы регистров остатков
Описанные в данном разделе методы используются только для регистров остатков.
Методы системы 1С:Предприятие как OLE Automation сервера
Система 1С:Предприятие в качестве OLE Automation сервера предоставляет полный доступ к своему глобальному контексту (см. «Контекст выполнения программного модуля»). Поэтому объект OLE-сервер 1С:Предприятие в качестве своих методов может иметь: системные процедуры и функции, а также процедуры и функции глобального программного модуля, объявленные с ключевым словом Экспорт. Кроме того, OLE-сервер 1С:Предприятие имеет три дополнительных метода: Initialize, EvalExpr, ExecuteBatch.
Методы внешних приложений
Методы внешних приложений, а также синтаксис их использования у каждого приложения свои. Описание процедур и функций внешнего приложений можно получить только в документации данного приложения. Например, практически все программы, входящие в пакет Microsoft Office используют для своего управления версию языка Visual Basic.
Чтобы вызвать метод внешнего приложения в языке системы 1С:Предприятие, имя метода (с указанием необходимых параметров) пишется через точку после имени ссылки на объект внешнего приложения.
Пример:
// Создаем объект Excel и присвоим его переменной языка
ОкноЕхсеl = СоздатьОбъект("Excel.Application");
// устанавливаем имя окна Excel
ОкноЕхсеl.Caption = "Отчет";
// создадим новую рабочую книгу
НовыеРабочиеКниги = ОкноЕхсеl.Workbooks;
РабочаяКнига = НовыеРабочиеКниги.Add();
Ограничения:
Не поддерживаются значения, передаваемые по ссылке;
Не поддерживаются массивы, в точности SAFEARRAY;
Не поддерживаются значения типа IUnknown.
Эти ограничения не столь серьезны, т. к. например, все типы данных, с которыми работает Excel и большинство других наиболее распространенных программ, полностью поддерживаются.
Типы поддерживаемых данных:
Boolean
Currency
Date
Double-precision floating-point
Integer
Long integer
Object
Single-precision floating-point
String
Пример:
//В данном примере запускается программа Excel,
// затем в нее передаются некоторые данные, и затем
// на их основе строится диаграмма.
// Создаем объект Excel и присвоим его переменной языка
ОкноЕхсеl = СоздатьОбъект("Excel.Application");
// устанавливаем имя окна Excel
ОкноЕхсеl.Caption = "Отчет";
// создадим новую рабочую книгу
НовыеРабочиеКниги = ОкноЕхсеl.Workbooks;
РабочаяКнига = НовыеРабочиеКниги.Аdd();
ЧислоРядов = 10;
ЧислоСтолбцов = 5;
// проставим названия строк
Для Ряд = 1 По ЧислоРядов Цикл
Ячейка = ОкноЕхсеl.Cells(Ряд + 1, 1);
Ячейка.Value = "Строка " + Строка(Ряд);
КонецЦикла;
// проставим названия столбцов
установим стили для рамки выделенной
Для Столбец = 1 По ЧислоСтолбцов Цикл
Ячейка = ОкноЕхсеl.Cells(1, Столбец + 1);
Ячейка.Value = "Столбец " + Строка(Столбец);
КонецЦикла;
// заполним ячейки таблицы значениями
Для Ряд = 1 По ЧислоРядов Цикл
Для Столбец = 1 По ЧислоСтолбцов Цикл
Ячейка = ОкноЕхсеl.Cells(Ряд + 1, Столбец + 1);
Ячейка.Value = Ряд + Столбец;
КонецЦикла;
КонецЦикла;
// выделим область в таблице и присвоим ее переменной языка
Область = ОкноЕхсеl.Range(ОкноЕхсеl.Cells(1, 1),
ОкноЕхсеl.Cells(ЧислоРядов + 1, ЧислоСтолбцов + 1));
// зададим имя выделенной области
Область.Name = "ОбластьДанных";
// определим рамку выделенной области и присвоим ее переменной языка
Рамка = Область.Borders;
// установим стили для рамки выделенной области
Рамка.LineStyle = 1;
Рамка.Colorlndex = 3;
// построим диаграмму Лист=РабочаяКнига.Worksheets(1);
Диаграмма = Лист.ChartObjects();
Диаграмма = Диаграмма.Add(5, 5 + Область.Тор + Область.Height,
Область.Width, Область.Height);
МояДиаграмма = Диаграмма.Chart;
МояДиаграмма.ChartWizard("ОбластьДанных ", -4102, 6, 1, 1, 1, 1, "Отчет");
// сделаем окно Excel видимым и активным
ОкноЕхсеl.Visible = 1;
Мин
Определить минимальное значение.
Синтаксис:
Мин(<Элемент1>, ..., <ЭлементN>)
Англоязычный синоним:
Min
Параметры:
|
<Элемент1>, ..., <ЭлементN> |
Список выражений базовых типов данных. |
Возвращаемое значение:
Значение минимального элемента из списка <Элемент1>, ..., <ЭлементN>
Описание:
Функция Мин определяет минимальное значение из списка <Элемент1>, ..., <ЭлементN>.
Тот или иной семантический вариант функции определяется по типу данных первого параметра. В случае несовпадения типа второго и последующих параметров с требуемым, их значения преобразуются к требуемому типу в соответствии с правилами преобразования типов. Если тип первого операнда не соответствует ни одному из допустимых типов, то в зависимости от ситуации может производиться преобразование типов или возбуждаться состояние ошибки исполнения.
Пример:
МинимЦена = Мин(Цена1, Цена2, ЦенаЗ);
МодальныйРежим
Возвращает режим работы формы.
Синтаксис:
МодальныйРежим()
Англоязычный синоним:
ModalMode
Возвращаемое значение:
Число: 0 — немодальный режим; 1 — модальный режим.
Описание:
Метод МодальныйРежим возвращает режим работы формы. Доступ к данному методу возможен только в контексте Модуля формы.
Пример:
РежимРаботыФормы = Форма.МодальныйРежим();
Модифицированность
Возвратить признак изменения реквизитов в текущей форме элемента справочника.
Синтаксис:
Модифицированность()
Англоязычный синоним:
Modify
Возвращаемое значение:
Числовое значение: 1 — если реквизиты текущей формы элемента справочника были изменены; 0 — если нет.
Описание:
Метод Модифицированность возвращает признак изменения (в режиме исполнения он отображается символом (*) в заголовке окна формы).
Замечание. Данный метод доступен только в контексте Модуля формы элемента справочника (см. «Виды программных модулей»). Действие данного метода относится только к текущему элементу справочника, который доступен в локальном контексте Модуля формы элемента справочника.
Пример:
Модифицированность
Возвратить признак изменения реквизитов текущей формы документа.
Синтаксис:
Модифицированность()
Англоязычный синоним:
Modify
Возвращаемое значение:
Числовое значение: 1 — если реквизиты текущей формы документа были изменены; 0 — если нет.
Описание:
Метод Модифицированность возвращает признак изменения реквизитов формы (в режиме исполнения он отображается символом (*) в заголовке окна формы).
Данный метод доступен только в Модуле формы документа(см. «Виды программных модулей»). Действие данного метода относится только к текущему документу, который доступен в локальном контексте Модуля формы документа.
Пример:
Изм = Модифицированность();
Модуль документа
Размещается в разделе
конфигурации: Метаданные — Документ — Модуль документа.
Запускается при проведении документа, при удалении проведенного документа, при снятии проведения, при выполнении архивации записей журнала расчетов, порожденных документом.
В модуле доступны: глобальный контекст, контекст Модуля документа, в котором непосредственно доступны реквизиты текущего документа.
Модуль Формы документа
Размещается в разделе конфигурации: Метаданные — Документ — Форма.
Запускается при открытии формы документа.
В модуле доступны: глобальный контекст, контекст Модуля формы документа, в котором непосредственно доступны реквизиты текущего документа и реквизиты формы документа.
Модуль Формы группы справочника
Размещается в разделе конфигурации: Метаданные — Справочник — Форма группы.
Запускается при открытии формы группы справочника.
В модуле доступны: глобальный контекст, контекст Модуля формы группы справочника, в котором непосредственно доступны реквизиты текущей группы справочника и реквизиты формы.
Модуль Формы элемента справочника
Размещается в разделе конфигурации: Метаданные — Справочник — Форма элемента.
Запускается при открытии формы элемента справочника.
В модуле доступны: глобальный контекст, контекст Модуля формы элемента справочника, в котором непосредственно доступны реквизиты текущего элемента справочника и реквизиты формы.
Модуль Формы обработки
Размещается в разделе конфигуратора: Метаданные — Обработка — Форма.
Запускается при открытии диалоговой формы обработки.
В модуле доступны: глобальный контекст, контекст Модуля формы обработки, в котором непосредственно доступны реквизиты формы.
Модуль Формы операции
Размещается в разделе конфигурации: Метаданные — Операция.
Запускается при открытии формы операции.
В модуле доступны: глобальный контекст, контекст Модуля формы операции, в котором непосредственно доступны реквизиты текущей операции и реквизиты формы операции.
Модуль Формы отчета
Размещается в разделе конфигуратора: Метаданные — Отчет — Форма.
Запускается при открытии диалоговой формы подготовки отчета.
В модуле доступны: глобальный контекст, контекст Модуля формы отчета, в котором непосредственно доступны реквизиты формы.
Модуль Формы счета
Размещается в разделе конфигурации: Метаданные — Справочник
— счет.
Запускается при открытии формы счета.
В модуле доступны: глобальный контекст, контекст Модуля формы счета, в котором непосредственно доступны реквизиты текущего счета и реквизиты формы.
Модуль Формы списка счетов
Размещается в разделе конфигурации: Метаданные — План счетов.
Запускается при вызове формы списка счетов.
В модуле доступны: глобальный контекст, контекст Модуля формы списка счетов, в котором непосредственно доступен выбранный в списке счет и реквизиты формы списка счетов.
Модуль Формы списка справочника
Размещается в разделе конфигурации: Метаданные — Справочник — Форма списка.
Запускается при вызове формы списка справочника.
В модуле доступны: глобальный контекст, контекст Модуля формы списка справочника, в котором непосредственно доступен выбранный в списке элемент справочника и реквизиты формы списка справочника.
Модуль Формы журнала документов
Размещается в разделе конфигурации: Метаданные — Журнал — Форма.
Запускается при вызове формы журнала документов.
В модуле доступны: глобальный контекст, контекст Модуля формы журнала документов, в котором непосредственно доступен выбранный в журнале документ и реквизиты формы журнала.
Модуль Формы журнала операций
Размещается в разделе конфигурации: Метаданные — Журнал операций — Форма.
Запускается при вызове формы журнала операций.
В модуле доступны: глобальный контекст, контекст Модуля формы журнала операций, в котором непосредственно доступны реквизиты журнала операций и реквизиты формы.
Модуль Формы журнала проводок
Размещается в разделе конфигурации: Метаданные — Журнал проводок — Форма.
Запускается при вызове формы журнала проводок.
В модуле доступны: глобальный контекст, контекст Модуля формы журнала проводок, в котором непосредственно доступны реквизиты журнала проводок и реквизиты формы.
Модуль Формы журнала расчетов
Размещается в разделе конфигурации: Метаданные — Журнал расчетов — Форма.
Запускается при вызове формы журнала расчетов.
В модуле доступны: глобальный контекст, контекст Модуля формы журнала расчетов, в котором непосредственно доступны реквизиты журнала расчетов и реквизиты формы.
Модуль вида расчета
Размещается в разделе конфигуратора: Метаданные — Вид расчета — Модуль вида расчета.
Запускается при расчете соответствующих записей журнала расчетов.
В модуле доступны: глобальный контекст, контекст Модуля вида расчета, в котором доступны реквизиты журнала расчетов.
МонопольныйРежим
Определение режима работы программы.
Синтаксис:
МонопольныйРежим()
Англоязычный синоним:
ExclusiveMode
Возвращаемое значение:
Число 1 — если программа запущена в монопольном режиме;
Число 0 — если программа запущена в сетевом режиме.
Описание:
Функция МонопольныйРежим возвращает число 1 — если программа запущена в монопольном режиме и 0 если нет.
Пример:
Процедура Загрузка()
Если МонопольныйРежим() > 0 Тогда
ЗагрузитьНаряды();
Иначе
Предупреждение("Для запуска этой операции требуется" +
"монопольный режим доступа !!!");
КонецЕсли;
КонецПроцедуры
НачалоИнтервала
Возвратить дату начала интервала журнала.
Синтаксис:
НачалоИнтервала()
Англоязычный синоним:
BegOfRange
Возвращаемое значение:
Значение даты начала интервала журнала.
Описание:
Метод НачалоИнтервала позволяет получить дату начала интервала журнала.
Данный метод доступен только в контексте Модуля формы журнала документов (см. «Виды программных модулей»).
Пример:
НИ = НачалоИнтервала();
НачалоИнтервала
Возвратить дату начала интервала журнала операций.
Синтаксис:
НачалоИнтервала()
Англоязычный синоним:
BegOfRange
Возвращаемое значение:
Значение типа «Дата» — начальная дата интервала журнала операций.
Описание:
Метод НачалоИнтервала позволяет получить текущую начальную дату интервала журнала операций.
Данный метод доступен только в контексте модуля формы журнала операций (см. «Виды программных модулей»).
Пример:
НИ = НачалоИнтервала();
НачалоИнтервала
Возвратить дату начала интервала журнала проводок.
Синтаксис:
НачалоИнтервала()
Англоязычный синоним:
BegOfRange
Возвращаемое значение:
Значение типа «Дата» — начальная дата интервала журнала проводок.
Описание:
Метод НачалоИнтервала позволяет получить начальную дату интервала журнала проводок.
Данный метод доступен только в контексте модуля формы журнала проводок (см. «Виды программных модулей»).
Пример:
НИ = НачалоИнтервала();
НачалоПериода
Возвращает дату начала периода формирования запроса.
Синтаксис:
НачалоПериода()
Англоязычный синоним:
BeginOfPeriod
Возвращаемое значение:
Значение типа «дата» — начало периода формирования запроса.
Описание:
Метод НачалоПериода возвращает дату начала периода запроса. Если в тексте запроса (см. «Язык запросов») указана одна из предопределенных группировок типа период ("Год", "Месяц", "День" и т. д.), то при обработке этой и вложенных в нее группировок метод НачалоПериода будет возвращать начало периодов текущих значений этих группировок.
Пример:
ДатаНачала = Запрос.НачалоПериода();
НачалоПериодаБИ
Возвращает дату начала периода бухгалтерских итогов.
Синтаксис:
НачалоПериодаБИ()
Англоязычный синоним:
BeginOfРег1odBT()
Возвращаемое значение:
Значение типа «Дата» — дата начала периода бухгалтерских итогов.
Описание:
Метод НачалоПериодаБИ возвращает дату начала периода бухгалтерских итогов, заданную в режиме «Настройка параметров системы».
Пример:
Дата1 = НачалоПериодаБИ();
НачалоПериодаПоДате
Возвращает дату начала произвольного расчетного периода.
Синтаксис:
НачалоПериодаПоДате{<Дата>)
Англоязычный синоним:
PeriodBeginByDate
Параметры:
|
<Дата> |
Любая дата, которая попадает в требуемый период. |
Возвращаемое значение:
Значение типа «дата» — начало расчетного периода журнала расчетов.
Описание:
Метод позволяет определить дату начала того периода журнала расчетов, в который попадает заданная <Дата>. Работа метода не зависит от наличия в журнале расчетов данных за соответствующий расчетный период.
Пример:
// В каждой строке журнала расчетов проставим в реквизит Дни
// количество банковских дней того периода расчета, в который
// попадает запись
ЖР = СоздатьОбъект("ЖурналРасчетов.Дивиденды");
Календ = СоздатьОбъект("Календарь.РаботаБанка");
ЖР.ВыбратьПериод(ЖР.НачалоТекущегоПериода());
Пока ЖР.ПолучитьЗапись() = 1 Цикл
ЖР.Дни = Календ.Дней(НачалоПериодаПоДате(ЖР.ДатаНачала),
КонецПериодаПоДате(ЖР.ДатаНачала));
КонецЦикла;
См. также: КонецПериодаПоДате
НачалоСтандартногоИнтервала
Устанавливает вариант задания начала стандартного интервала отображения журнала документов.
Синтаксис:
НачалоСтандартногоИнтервала(<Вариант>)
Англоязычный синоним:
BegOfStandrdRange
Параметры:
|
<Вариант> |
Необязательный параметр. Выражение со значением типа строка или дата. Возможные строковые значения параметра: "День", "Месяц", "Квартал", "Год", "Day", "Month", "Quarter", "Year". Значением типа «дата» задается конкретная дата начала интервала журнала документов. Если параметр не задан, то установка сделанная в параметрах системы не меняется, а только возвращается текущий вариант. |
Возвращаемое значение:
Возвращает текущий установленный вариант.
Описание:
Функция НачалоСтандартногоИнтервала устанавливает вариант зада ния начала стандартного интервала отображения журнала документов. Вариан может изменяться при помощи главного меню Сервис-Параметры-Общие.
Пример:
НачалоСтандартногоИнтервала("Месяц");
НачалоТекущегоПериода
Возвращает дату начала текущего расчетного периода.
Синтаксис:
НачалоТекущегоПериода()
Англоязычный синоним:
CurrentPeriodBegin
Возвращаемое значение:
Значение типа «дата» — начало текущего расчетного периода журнала расчетов.
Описание:
Возвращает дату начала текущего периода журнала расчетов. Текущий период — отрезок времени, обсчитываемый журналом расчетов в данный момент. Величина расчетного периода журнала расчетов определяется при конфигурировании журнала и может принимать значения: день, неделя, месяц, квартал, год.
Текущий период журнала расчетов устанавливается при выполнении операции «Установить период расчета» меню «Действия» журнала расчетов. В случае, если периодичность журнала расчетов равна дню, методы НачалоТекущегоПериода и КонецТекущегоПериода возвращают одно и то же значение.
Пример:
//
ЖРЗарп = СоздатьОбъект("ЖурналРасчета.Зарплата");
Начало = ЖРЗарп.НачалоТекущегоПериода();
См. также: КонецТекущегоПериода, ПериодДействия, ПериодРегистрации
НачатьТранзакцию
Открыть обработку транзакции.
Синтаксис:
НачатьТранзакцию()
Англоязычный синоним:
BeginTransaction
Описание:
Процедура НачатьТранзакцию открывает транзакцию для обработки информации.
Пример:
Процедура УдалитьПустые()
Спр = СоздатьОбъект("Справочник.Подразделения");
Спр.ВыбратьЭлементы();
НачатьТранзакцию();
Пока Спр.ПолучитьЭлемент() = 1 Тогда
Если Спр.Количество = 0 Тогда
Спр.Удалить();
КонецЕсли;
КонецПока;
ЗафиксироватьТранзакцию();
КонецПроцедуры
НачДата
Начальная дата периода, за который извлекаются результаты запроса.
Синтаксис:
НачДата
Англоязычный синоним:
BegDate
Описание:
Атрибут НачДата содержит начальную дату периода, за который извлекаются итоги при использовании методов обхода периодов ВыбратьПериоды и ПолучитьПериод.
Пример:
БухИтоги.ВыполнитьЗапрос(Дата1, Дата2, , , , , "Месяц");
БухИтоги.ВыбратьСчета();
Пока БухИтоги.ПолучитьСчет() = 1 цикл
БухИтоги.ВыбратьПериоды();
Пока БухИтоги.ПолучитьПериод() = 1 цикл
Сообщить("С " + БухИтоги.НачДата.Код + " по " + БухИтоги.КонДата +
" ДО = " + БухИтоги.ДО());
КонецЦикла;
КонецЦикла;
НачГода
Определить дату начала года.
Синтаксис:
НачГода(<Дата>)
Англоязычный синоним:
BegOfYear
Параметры:
|
<Дата> |
Выражение со значением типа «дата». |
Возвращаемое значение:
Результирующая дата.
Описание:
Функция НачГода определяет дату начала года для указанной даты.
Пример:
ДатаНачалаГода = НачГода(РабочаяДата());
НачКвартала
Определить дату начала квартала.
Синтаксис:
НачКвартала(<Дата>)
Англоязычный синоним:
BegOfQuart
Параметры:
|
<Дата> |
Выражение со значением типа «дата». |
Возвращаемое значение:
Результирующая дата.
Описание:
Функция НачКвартала определяет дату начала квартала для указанной даты.
Пример:
ДатаНачалаКвартала = НачКвартала(РабочаяДата());
НачМесяца
Определить дату начала месяца.
Синтаксис:
НачМесяца(<Дата>)
Англоязычный синоним:
BegOfMonth
Параметры:
|
<Дата> |
Выражение со значением типа «дата». |
Возвращаемое значение:
Результирующая дата.
Описание:
Функция НачМесяца определяет дату начала месяца для указанной даты.
Пример:
ДатаНачалаМесяца = НачМесяца(РабочаяДата());
НачНедели
Определить дату начала недели.
Синтаксис:
НачНедели(<Дата>)
Англоязычный синоним:
BegOfWeek
Параметры:
|
<Дата> |
Выражение со значением типа «дата». |
Возвращаемое значение:
Результирующая дата.
Описание:
Функция НачНедели определяет дату начала недели для указанной даты.
Пример:
ДатаНачалаНедели = НачНедели(РабочаяДата());
НачПериода
Выдает начальную дату установленного в данный момент периода основных итогов.
Синтаксис:
НачПериода()
Англоязычный синоним:
BeginOfPeriod
Возвращаемое значение: Начальная дата периода.
Описание:
Метод НачПериода используется для определения начальной даты основных итого выдаваемых объектом.
Пример:
Сообщить(ПериодСтр(БухИтоги.НачПериода(), БухИтоги.КонПериода());
Наименование
Значение реквизита Наименование.
Синтаксис:
Наименование
Англоязычный синоним:
Description
Описание:
Атрибут Наименование предоставляет доступ к значению обязательного реквизита "Наименование" выбранного элемента справочника.
Пример:
Спр = СоздатьОбъект("Справочник.Подразделения");
Спр.НайтиПоКоду("29");
Подразделение = Спр.Наименование;
