Описанные в данном разделе методы доступны только в контексте Модуля формы элемента справочника (см. «Виды программных модулей»).
Возвратить признак изменения реквизитов в текущей форме элемента справочника.
Синтаксис:
Модифицированность()
Англоязычный синоним:
Modify
Возвращаемое значение:
Числовое значение: 1 — если реквизиты текущей формы элемента справочника были изменены; 0 — если нет.
Описание:
Метод Модифицированность возвращает признак изменения (в режиме исполнения он отображается символом (*) в заголовке окна формы).
Замечание. Данный метод доступен только в контексте Модуля формы элемента справочника (см. «Виды программных модулей»). Действие данного метода относится только к текущему элементу справочника, который доступен в локальном контексте Модуля формы элемента справочника.
Пример:
Установить дату, на которую будут записываться периодические реквизиты элемента справочника, форма которого открыта.
Синтаксис:
ИспользоватьДату(<Дата>, <Обновить>)
Англоязычный синоним:
UseDate
Параметры:
|
<Дата> |
Выражение со значением типа «дата». Дата, на которую будут записываться периодические реквизиты элемента справочника, форма которого открыта. |
|
<Обновить> |
Необязательный параметр. Число: 1 — обновить периодические реквизиты формы на заданную дату; 0 — не обновлять периодические реквизиты формы. Значение по умолчанию — 0; |
Возвращаемое значение:
Значение используемой даты (на момент до исполнения метода).
Описание:
Метод ИспользоватьДату устанавливает для элемента справочника дату, на которую будут записываться периодические реквизиты.
Если данный метод опущен, то значения выбранных периодических реквизитов справочника будут записываться на текущую рабочую дату.
Замечание. Данный метод доступен только в контексте Модуля формы элемента справочника (см. «Виды программных модулей»). Действие данного метода относится только к текущему элементу справочника, который доступен в локальном контексте Модуля формы элемента справочника.
Пример:
// Здесь мы работаем в локальном контексте модуля Формы
// элемента справочника.
// в справочнике есть несколько реквизитов,
// которые являются периодическими реквизитами.
// В форме существует элемент диалога ВыбДата типа «Дата»
Если Число(ВыбДата) <> 0 Тогда
// задано некоторое значение ВыбДата
ИспользоватьДату(ВыбДата);
КонецЕсли;
Установить режим отображения диалога сохранения периодических реквизитов при записи элемента справочника.
Синтаксис:
СохранениеПериодическихРеквизитов(<ВариантВызова>, <Список>)
Англоязычный синоним:
Рег1odicAttributesSaving
Параметры:
|
<ВариантВызова> |
Число, определяет вариант вызова метода: 0 — отключить автоматический режим определения списка измененных реквизитов и показ диалога (параметр <Список> не используется); 1 — включить автоматический режим определения списка измененных реквизитов с показом диалога (параметр <Список> определяет набор анализируемых реквизитов); 2 — включить автоматический режим определения списка измененных реквизитов без показа диалога (параметр <Список> определяет набор анализируемых реквизитов); 3 — выполнить определение списка измененных реквизитов с показом диалога (параметр <Список> определяет набор анализируемых реквизитов); 4 — выполнить определение списка измененных реквизитов без показа диалога (параметр <Список> определяет набор анализируемых реквизитов); 5 — выдать/установить список сохраняемых периодических реквизитов. Метод возвращает установленный список периодических реквизитов, которые будут записываться на момент до вызова метода. Если параметр <Список> указан, то устанавливается список периодических реквизитов, которые должны быть записаны. |
|
<Список> |
Необязательный параметр. Строковое выражение, в котором через запятую перечислены имена периодических реквизитов справочника, которые должны выводится в диалоге (если диалог показывается), или по которым будет записан элемент истории (если диалог не показывается). По умолчанию предполагается, что в списке все периодические реквизиты справочника. Если указан символ "*", то считается, что в список включены все периодические реквизиты справочника. |
Описание:
Метод СохранениеПериодическихРеквизитов управляет режимом ав-томатического определения списка измененных периодических реквизитов, показом диалога для выбора записываемых периодических реквизитов, а также предоставляет доступ непосредственно к списку записываемых периодических реквизитов.
Если данный метод опущен, то при записи элемента справочника диалог отображается со всеми периодическими реквизитами.
Замечание. Данный метод доступен только в контексте Модуля формы элемента справочника (см. «Виды программных модулей»). Действие данного метода относится только к текущему элементу справочника, который доступен в локальном контексте Модуля формы элемента справочника.
Пример:
// Здесь мы работаем в локальном контексте модуля Формы
// элемента справочника.
// в справочнике есть несколько реквизитов,
// которые являются периодическими реквизитами.
СохранениеПериодическихРеквизитов(1, "ЦенаРозн, ЦенаОптов");
Установить список периодических реквизитов, просмотр истории которых допускается.
Синтаксис:
ПросмотрИстории(<СписокРеквизитов>)
Англоязычный синоним:
ViewHistory
Параметры:
|
<СписокРеквизитов> |
Строка со списком идентификаторов (через запятую) тех реквизитов, просмотр истории которых допускается. |
Возвращаемое значение:
Текущий (на момент до вызова метода) список реквизитов, просмотр истории которых допускается просмор истории.
Описание:
Метод ПросмотрИстории позволяет установить список реквизитов для которых допускается просмор истории .
Замечание. Данный метод доступен только в контексте Модуля формы элемента справочника (см. «Виды программных модулей»). Действие данного метода относится только к текущему элементу справочника, который доступен в локальном контексте Модуля формы элемента справочника.
Пример:
Процедура ПриОткрытии()
ПросмотрИстории;"Оклад, Тариф, Подразделение");
КонецПроцедуры
Описанные в данном разделе системные предопределенные процедуры должны располагаться только в Модулях форм справочника (см. «Виды программных модулей»). К ним относятся программные модули: Модуль формы элемента справочника, Модуль формы группы справочника.
В основном данные процедуры предназначены для расширения возможности программного управления правами доступа к системе.
Системные предопределенные процедуры не является встроенными процедурами языка. Для них зарезервированы только название и синтаксис. Тело процедур должно быть написано самим разработчиком в соответствующих программных модулях. Вызов предопределенных процедур на исполнение производится в системе 1С:Предприятие неявно при возникновении соответствующего события. Описание предопределенных процедур также см. гл. «Системные предопределенные процедуры».
Предопределенная процедура при вводе нового элемента справочника.
Синтаксис:
ВводНового(<ПризнКопирования>, <ОбъектКопирования>)
Англоязычный синоним:
InputNew
Параметры:
|
<ПризнКопирования> |
Признак того, что объект введен копированием. Число: 1 — объект введен копированием, 0 — просто новый объект. Данный признак может быть использован для анализа необходимости инициализации реквизитов нового объекта. |
|
<ОбъектКопирования> |
Объект, который был скопирован. |
Описание:
Вызов процедуры ВводНового производится в системе 1С:Предприятие неявно в момент выбора пункта меню "Действия" — "Новый" при работе со справочниками. Данная процедура может использоваться, например, для установки начальных значений (по умолчанию) реквизитов нового элемента справочника. Если в данной предопределенной процедуре установить статус возврата — 0 (например, если данному пользователю нельзя вводить новые элементы), ввода нового элемента и открытие его формы не будет выполнено.
Процедуру ВводНового контекста справочников можно размещать в следующих программных модулях: Модуль формы элемента справочника, Модуль формы группы справочника (см. «Виды программных модулей»).
Пример:
Процедура ВводНового();
Оклад = 1000000;
Пдр = СоздатьОбъект("Справочник.Подразделения");
Пдр.НайтиПоКоду(1);
Подразделение = Пдр.ТекукщийЭлемент();
Город = Константа.НашГород;
КонецПроцедуры
См. также: СтатусВозврата
Предопределенная процедура при записи элемента справочника.
Синтаксис:
ПриЗаписи(<СписокПериодРекв>)
Англоязычный синоним:
OnWrite
Параметры:
|
<СписокПериодРекв> |
Строковое значение — список разделенных запятыми изменяемых периодических реквизитов справочника. В данный параметр система 1С:Предприятие передает перечень периодических реквизитов, которые были интерактивно выбраны пользователем для обновления в окне диалога выбора. В теле процедуры значение данного параметра может быть изменено, что позволяет в данной процедуре непосредственно управлять списком записываемых значений периодических реквизитов. |
Описание:
Вызов предопределенной процедуры ПриЗаписи производится системой 1С:Предприятие при интерактивной записи элемента справочника. Если в данной предопределенной процедуре установить статус возврата — 0 (например, если данному пользователю нельзя изменять некоторые элементы справочника), то запись элемента справочника не будет выполнена.
Данная предопределенная процедура может располагаться в следующих программных модулях: Модуль формы элемента справочника, Модуль формы группы справочника, Модуль формы списка справочника (см. Виды программных модулей).
Пример:
Процедура ПриЗаписи (СписокРекв)
Если НазваниеНабораПрав() = "Продавец" Тогда
Если ТекущийЭлемент() = Константа.НашаФирма Тогда
Предупреждение("У вас нет права менять реквизиты!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
Описанные в данном разделе методы доступны только в контексте Модуля формы списка справочника (см. «Виды программных модулей»).
Установить дату выборки периодических реквизитов формы списка справочника.
Синтаксис:
ИспользоватьДату(<Дата>)
Англоязычный синоним:
UseDate
Параметры:
|
<Дата> |
Выражение со значением типа «дата» |
Возвращаемое значение:
Значение даты выборки периодических реквизитов формы списка справочника.
Описание:
Метод ИспользоватьДату устанавливает для формы списка справочника дату, на которую будут в дальнейшем выбираться (или записываться) значения периодических реквизитов справочника.
Данный метод доступен только в контексте Модуля формы списка справочника (см. «Виды программных модулей»). Действие данного метода относится только к текущему справочнику, который доступен в локальном контексте Модуля формы списка справочника.
Пример:
ИспользоватьДату(ДатаДок);
Установить владельца для формы списка подчиненного справочника.
Синтаксис:
ИспользоватьВладельца(<Владелец>, <ФлагИзменения>)
Англоязычный синоним:
UseOwner
Параметры:
|
<Владелец> |
Необязательный параметр. Выражение со значением элемента справочника — нового владельца. Если параметр не задан, то значение владельца не меняется. |
|
<ФлагИзменения> |
Необязательный параметр. Этим флагом регулируется возможность интерактивного изменения владельца, 1 — пользователь может изменить владельца интерактивно, 0 — пользователь не может интерактивно изменить владельца. Если параметр не задан, то значение флага не меняется. |
Возвращаемое значение:
Значение владельца для формы списка подчиненного справочника (до применения метода).
Описание:
Метод ИспользоватьВладельца устанавливает элемент связанного справочника (которому подчинен текущий справочник) в качестве владельца для формы списка подчиненного справочника.
Данный метод доступен в контексте Модуля формы списка справочника (см. «Виды программных модулей»). Действие данного метода относится ко всему текущему подчиненному справочнику, который доступен в локальном контексте Модуля формы списка справочника.
При добавлении нового элемента текущего справочника данный параметр также будет являться свойством нового элемента.
Пример:
ИспользоватьВладельца(Сотр, 0);
Установить родителя для формы списка справочника.
Синтаксис:
ИспользоватьРодителя(<Родитель>, <ФлагИзменения>)
Англоязычный синоним:
UseParent
Параметры:
|
<Родитель> |
Необязательный параметр. Выражение со значением группы справочника- нового родителя. Если параметр не задан, то значение родителя не меняется. |
|
<ФлагИзменения > |
Необязательный параметр. Этим флагом регулируется возможность интерактивного изменения родителя. 1 — пользователь может изменить родителя интерактивно, 0 — пользователь не может интерактивно изменить родителя. Если параметр не задан, то значение флага не меняется. |
Возвращаемое значение:
Значение родителя для формы списка справочника (до применения метода).
Описание:
Метод ИспользоватьРодителя устанавливает группу справочника в качестве родителя для формы списка справочника.
Данный метод доступен в контексте Модуля формы списка справочника (см. «Виды программных модулей»). Действие данного метода относится ко всему текущему справочнику, который доступен в локальном контексте Модуля формы списка справочника.
При добавлении нового элемента текущего справочника данный параметр также будет являться свойством нового элемента.
Пример:
ИспользоватьРодителя(ВыбГруппаСотр, 1);
Установить режим иерархического списка справочника.
Синтаксис:
ИерархическийСписок(<ФлагИерархСписка>, <ФлагИзменения>)
Англоязычный синоним:
HierarchicalList
Параметры:
|
<ФлагИерархСписка> |
Флаг иерархического списка. 1 — иерархический список; 0 — неиерархический список. |
|
<ФлагИзменения> |
Необязательный параметр. Этим флагом регулируется возможность интерактивного изменения флага иерархического списка. 1 — пользователь может изменить иерархичность интерактивно, 0 — пользователь не может интерактивно изменить иерархичность. |
Возвращаемое значение:
Значение флага иерархического списка для формы списка справочника (до применения метода).
Описание:
Метод ИерархическийСписок устанавливает режим иерархического списка справочника.
Данный метод доступен в контексте Модуля формы списка справочника (см. «Виды программных модулей»). Действие данного метода относится ко всему текущему списку справочника, который доступен в локальном контексте Модуля формы списка справочника.
Пример:
ИерархическийСписок(1, 1);
Установить режим выборки групп.
Синтаксис:
ВыборГруппы(<Режим>)
Англоязычный синоним:
SelectGroup
Параметры:
|
<Режим> |
Необязательный параметр. Числовое выражение: 1 — выбирать группы; 0 — не выбирать группы. |
Возвращаемое значение:
Текущее числовое значение режима выборки групп (на момент до исполнения метода).
Описание:
Метод ВыборГруппы устанавливает режим выборки групп для формы списка справочника, которая открыта в режиме выбора или подбора элемента.
По умолчанию, выборка элементов справочников для полей в формах документов, журналов и справочников установлена без выбора групп, а в форме отчета с выбором групп. Поэтому реально имеет смысл применять данный метод только в том случае, если надо изменить режим выборки групп.
Пример:
// Задаем выборку без групп
ВыборГруппы(0);
Установить способ редактирования элементов справочника.
Синтаксис:
РедактироватьВДиалоге(<Способ>, <Разрешение>)
Англоязычный синоним:
EditInForm
Параметры:
|
<Способ> |
Необязательный параметр. Способ редактирования элемента справочника: 1 — в диалоге; 0 — в строке. |
|
<Разрешение> |
Необязательный параметр. Флаг разрешения пользователю менять способ редактирования: 1 — разрешить; 0 — запретить. |
Возвращаемое значение:
Значение установленного на данный момент способа редактирования элементов справочника (до применения метода).
Описание:
Метод РедактироватьВДиалоге устанавливает способ редактирования элементов справочника.
Данный метод доступен в контексте Модуля формы списка справочника (см. «Виды программных модулей»). Действие данного метода относится ко всему текущему списку справочника, который доступен в локальном контексте Модуля формы списка справочника.
Пример:
ТекСп = РедактироватьВДиалоге();
// какой сейчас способ?
РедактироватьВДиалоге(1);
// установить редактирование в диалоге
РедактироватьВДиалоге(1, 0);
// установить редактирование в диалоге
// и запретить его менять
Установить режим отображения диалога сохранения периодических реквизитов при записи элемента справочника.
Синтаксис:
СохранениеПериодическихРеквизитов(<ВариантВызова>, <Список>)
Англоязычный синоним:
Рег1odicAttributesSaving
Параметры:
|
<ВариантВызова> |
Число, определяет вариант вызова метода: 0 — отключить автоматический режим определения списка измененных реквизитов и показ диалога (параметр <Список> не используется); 1 — включить автоматический режим определения списка измененных реквизитов с показом диалога (параметр <Список> определяет набор анализируемых реквизитов); 2 — включить автоматический режим определения списка измененных реквизитов без показа диалога (параметр <Список> определяет набор анализируемых реквизитов); 3 — выполнить определение списка измененных реквизитов с показом диалога (параметр <Список> определяет набор анализируемых реквизитов); 4 — выполнить определение списка измененных реквизитов без показа диалога (параметр <Список> определяет набор анализируемых реквизитов); 5 — выдать/установить список сохраняемых периодических реквизитов. Метод возвращает установленный список периодических реквизитов, которые будут записываться на момент до вызова метода. Если параметр <Список> указан, то устанавливается список периодических реквизитов, которые должны быть записаны. |
|
<Список> |
Необязательный параметр. Строковое выражение, в котором через запятую перечислены имена периодических реквизитов справочника, которые должны выводится в диалоге (если диалог показывается), или по которым будет записан элемент истории (если диалог не показывается). По умолчанию предполагается, что в списке все периодические реквизиты справочника. Если указан символ "*", то считается, что в список включены все периодические реквизиты справочника. |
Описание:
Метод СохранениеПериодическихРеквизитов управляет режимом автоматического определения списка измененных периодических реквизитов, показом диалога для выбора записываемых периодических реквизитов, а также предоставляет доступ непосредственно к списку записываемых периодических реквизитов.
Если данный метод опущен, то при записи элемента справочника диалог отображается со всеми периодическими реквизитами.
Данный метод доступен в контексте Модуля формы списка справочника (см. «Виды программных модулей»). Действие данного метода относится ко всему текущему списку справочника, который доступен в локальном контексте Модуля формы списка справочника.
Пример:
СохранениеПериодическихРеквизитов(1, "ЦенаРозн, ЦенаОптов");
Установить способ сортировки элементов справочника.
Синтаксис:
Сортировка(<Способ>, <Разрешение>)
Англоязычный синоним:
SortOrder
Параметры:
|
<Способ> |
Строка с именем устанавливаемой сортировки. Это может быть (в зависимости от языка по умолчанию) "Код\Code", "Наименование\Description" или имя реквизита по которому устанавливается сортировка. |
|
<Разрешение> |
Необязательный параметр. Флаг разрешения пользователю менять способ сортировки: 1 — разрешить; 0 — запретить. |
Возвращаемое значение:
Возвращает текущее значение установленного на данный момент способа сортировки элементов справочника (до применения метода).
Описание:
Метод Сортировка позволяет установить способ сортировки элементов справочника.
Данный метод доступен в контексте Модуля формы списка справочника (см. «Виды программных модулей»).
Пример:
// установить сортировку по наименовнаию и запретить ее менять
Сортировка("Наименование", 0);
// получить текущее значение сортировки и установить сортировку по
// реквизиту "Оклад"
СтСорт = Сортировка("Оклад");
Установить отбор списка справочника.
Синтаксис:
УстановитьОтбор(<ИмяОтбора>, <3начение0тбора>)
Англоязычный синоним:
SetSelection
Параметры:
|
<ИмяОтбора> |
Строковое выражение — строка с именем реквизита справочника (по которому возможен отбор — флажок свойств «Отбор по реквизиту»), по которому установлен отбор. Если это значение пустое, то отбор отключается. |
|
<ЗначениеОтбора> |
Необязательный параметр. Значение отбора. |
Описание:
Метод УстановитьОтбор принудительно устанавливает отбор для списка справочника.
Данный метод доступен в контексте Модуля формы списка справочника (см. «Виды программных модулей»). Действие данного метода относится ко всему текущему списку справочника, который доступен в локальном контексте Модуля формы списка справочника.
Пример:
Процедура ПриОткрытии()
Перем Тип;
Перем Знач;
БылОтбор = ПолучитьОтбор(Тип, Знач);
Если .... Тогда
// что-нибудь проверяем
УстановаитьОтбор("Имя", "Коля");
ИначеЕсли БылОтбор = 1 Тогда
// вернем назад
УстановитьОтбор(Тип, Знач);
КонецЕсли;
КонецПроцедуры
Возвратить текущее значение отбора списка справочника.
Синтаксис:
ПолучитьОтбор(<ИмяОтбора>, <3начение0т6ора>)
Англоязычный синоним:
GetSelection
Параметры:
|
<ИмяОтбора> |
Имя переменной, куда вернется строковое значение имени отбора. |
|
<ЗначениеОтбора> |
Имя переменной, куда вернется значение отбора. |
Возвращаемое значение:
Числовое значение: 1 — есть отбор; 0 — если нет отбора.
Описание:
Метод ПолучитьОтбор возвращает текущее значение отбора списка справочника.
Данный метод доступен в контексте Модуля формы списка справочника (см. «Виды программных модулей»). Действие данного метода относится ко всему текущему списку справочника, который доступен в локальном контексте Модуля формы списка справочника.
Пример:
См. пример для предыдущей функции.
Установить доступные виды отборов списка справочника для вызова их в интерактивном режиме.
Синтаксис:
ВидыОтбора(<СписокИменОтборов>)
Англоязычный синоним:
KindsOfSelection
Параметры:
|
<СписокИменОтборов> |
Строка со списком (через запятую) имен тех реквизитов, отбор по которым допускается, или символ "*" — для всех видов отборов. |
Возвращаемое значение:
Строковое значение, содержащее текущий список имен отборов, разделенных запятыми (на момент до исполнения метода).
Описание:
Метод ВидыОтбора позволяет установить доступные виды отборов списка справочника для вызова их в интерактивном режиме.
Данный метод доступен в контексте Модуля формы списка справочника (см. «Виды программных модулей»). Действие данного метода относится ко всему текущему списку справочника, который доступен в локальном контексте Модуля формы списка справочника.
Пример:
Процедура ПриОткрытии()
ВидыОтбора("Имя, Оклад");
КонецПроцедуры
Установить в форме списка справочника закладки для интерактивного осуществления отбора.
Синтаксис:
ЗакладкиОтбора(<ИмяОтбора>, <3начение0тбора>)
Англоязычный синоним:
TabCtrlSelection
Параметры:
|
<ИмяОтбора> |
Строковое выражение, содержащее имя отбора. |
|
<ЗначениеОтбора> |
Значение отбора, который будет установлен первоначально. |
Описание:
Метод ЗакладкиОтбора устанавливает в форме списка справочника закладки для интерактивного осуществления отбора.
Данный метод доступен только в контексте Модуля формы списка справочника (см. «Виды программных модулей»).
Пример:
ЗакладкиОтбора("Имя", "Коля");
Реализует фильтрацию элементов справочника используя нединамический фильтр.
Синтаксис:
ИспользоватьСписокЭлементов (<СписокЗначений>)
Англоязычный синоним:
UseItemList
Параметры:
|
<СписокЗначений> |
Необязательный параметр. Значение типа «СписокЗначений». Должен представлять собой список элементов справочника, выбранных для просмотра. Если это значение пустое, то фильтр отключается. |
Описание:
Метод ИспользоватьСписокЭлементов реализует фильтрацию элементов справочника. Устанавливает нединамический фильтр.
Рекомендуется применять в предопределенных процедурах ПриСменеРодителя, ПриОткрытии, ПриСменеИерархии. При этом формируется список «разрешенных» элементов, который передается форме списка справочника при помощи данного метода. Данный список должен являться подмножеством тех элементов, которые обычно отображаются в форме списка без применения фильтра.
После вызова метода ИспользоватьСписокЭлементов форма списка справочника не позволяет вводить новый элемент, копировать и т. п.
Данный метод доступен в контексте Модуля формы списка справочника (см. «Виды программных модулей»). Действие данного метода относится ко всему текущему списку справочника, который доступен в локальном контексте Модуля формы списка справочника.
Пример:
Процедура УстановитьФильтр(ВыбПризнак)
Список.СоздатьОбъект("СписокЗначений");
Буфер = СоздатьОбъект("Справочник.Главн");
// отбираем только те элементы, которые могут отображаться в текущем списке
Буфер.ИспользоватьРодителя(ИспользоватьРодителя());
Буфер.ВключатьПодчиненные(0);
Буфер.ВыбратьЭлементы();
Пока Буфер.ПолучитьЭлемент() = 1 Цикл
// отбираем только те элементы, которые удовлетворяют заданному признаку
Если (Буфер.Признак = ВыбПризнак) Тогда
Список.ДобавитьЗначение(Буфер.ТекущийЭлемент());
КонецЕсли;
КонецЦикла;
ИспользоватьСписокЭлементов(Список);
КонецПроцедуры
Установить список периодических реквизитов, просмотр истории которых допускается.
Синтаксис:
ПросмотрИстории(<СписокРеквизитов>)
Англоязычный синоним:
ViewHistory
Параметры:
|
<СписокРеквизитов> |
Строка со списком идентификаторов (через запятую) тех реквизитов, просмотр истории которых допускается. |
Возвращаемое значение:
Текущий (на момент до вызова метода) список реквизитов, просмотр истории которых допускается просмор истории.
Описание:
Метод ПросмотрИстории позволяет установить список реквизитов для которых допускается просмор истории .
Данный метод доступен в контексте Модуля формы списка справочника (см. «Виды программных модулей»). Действие данного метода относится ко всему текущему списку справочника, который доступен в локальном контексте Модуля формы списка справочника.
Пример:
Процедура ПриОткрытии()
ПросмотрИстории("Оклад, Тариф, Подразделение");
КонецПроцедуры
Описанные в данном разделе системные предопределенные процедуры должны располагаться только в Модулях формы списка справочника (см. «Виды программных модулей»).
В основном данные процедуры предназначены для расширения возможности программного управления правами доступа к системе.
Предопределенные процедуры не является встроенными процедурами языка. Для них зарезервированы только название и синтаксис. Тело процедур должно быть написано самим разработчиком в соответствующих программных модулях. Вызов предопределенных процедур на исполнение производится в системе 1С:Предприятие неявно при возникновении соответствующего события. Описание предопределенных процедур также см. гл. «Системные предопределенные процедуры».
Предопределенная процедура при вводе новой строки списка справочника.
Синтаксис:
ПриВводеСтроки()
Англоязычный синоним:
OnNewLine
Описание:
Вызов предопределенной процедуры ПриВводеСтроки производится в системе 1С:Предприятие при интерактивном вводе новой строки (до начала ввода) в форме списка справочника. Если в данной предопределенной процедуре установить статус возврата — 0 (например, если данному пользователю нельзя вводить новые строки списка справочника), то новая строка списка справочника не будет инициирована.
Данная предопределенная процедура может располагаться в Модуле формы списка справочника (см. «Виды программных модулей»).
Пример:
Процедура ПриВводеСтроки()
Если НазваниеНабораПрав() = "Продавец" Тогда
Предупреждение("У вас нет права добавлять строки!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
Предопределенная процедура при редактировании новой строки списка справочника.
Синтаксис:
ПриРедактированииНовойСтроки()
Англоязычный синоним:
OnEditNewLine
Описание:
Вызов предопределенной процедуры ПриРедактированииНовойСтроки производится в системе 1С:Пред приятие в момент начала интерактивного редактирования новой строки списка справочника (после того, как новая строка уже заведена). Данная процедура может использоваться, например, для установки начальных значений (по умолчанию) реквизитов нового элемента справочника. В данной предопределенной процедуре установка статуса возврата не
имеет смысла, т. к. отказаться от ввода новой строки в этот момент уже невозможно.
Данная предопределенная процедура может располагаться в Модуле формы списка справочника (см. «Виды программных модулей»).
Пример:
Процедура ПриРедактированииНовойСтроки()
Оклад = 100000;
Пдр = СоздатьОбъект("Справочник.Подразделения");
Пдр.НайтиПоКоду(1);
Подразделение = Пдр.ТекукщийЭлемент();
Город = Константа.НашГород;
КонецПроцедуры
Предопределенная процедура при начале редактирования существующей строки списка справочника.
Синтаксис:
ПриНачалеРедактированияСтроки()
Англоязычный синоним:
OnStartEditLine
Описание:
Вызов предопределенной процедуры ПриНачалеРедактированияСтроки производится в системе 1С:Пред приятие в момент начала интерактивного редактирования существующей строки списка справочника (кроме новой). Если в данной предопределенной процедуре установить статус возврата — 0 (например, если данному пользователю нельзя изменять значения реквизитов справочника), запись не будет изменена.
Данная предопределенная процедура может располагаться в Модуле формы списка справочника (см. «Виды программных модулей»).
Пример:
Процедура ПриНачалеРедактированияСтроки()
Если НазваниеНабораПрав() = "Продавец" Тогда
Предупреждение("У вас нет права менять реквизиты!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
Предопределенная процедура при записи строки списка справочника.
Синтаксис:
ПриЗаписи(<СписокПериодРекв>)
Англоязычный синоним:
OnWrite
Параметры:
|
<СписокПериодРекв> |
Строковое значение — список разделенных запятыми изменяемых периодических реквизитов справочника. В данный параметр система 1С:Предприятие передает перечень периодических реквизитов, которые были интерактивно выбраны пользователем для обновления в окне диалога выбора. |
Описание:
Вызов предопределенной процедуры ПриЗаписи производится системой 1С:Предприятие при интерактивной записи строки списка справочника. Если в данной предопределенной процедуре установить статус возврата — 0 (например, если данному пользователю нельзя изменять некоторые элементы справочника), то запись строки списка справочника не будет выполнена.
Формальный параметр <СписокПериодРекв> используется в теле процедуры для обработки события интерактивной записи строки списка справочника.
Данная предопределенная процедура может располагаться в следующих программных модулях: Модуль формы элемента справочника, Модуль формы группы справочника, Модуль формы списка справочника, Модуль формы списка справочника (см. Виды программных модулей).
Пример:
Процедура ПриЗаписи (СписокРекв)
Если НазваниеНабораПрав() = "Продавец" Тогда
Если ТекущийЭлемент() = Константа.НашаФирма Тогда
Предупреждение("У вас нет права менять реквизиты!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
Предопределенная процедура переноса элемента справочника в другую группу.
Синтаксис:
ПриПереносеЭлементаВДругуюГруппу(<Элемент>, <Группа>)
Англоязычный синоним:
OnMoveIntoOtherGroup
Параметры:
|
<Элемент> |
Значение элемента справочника, который переносится. |
|
<Группа> |
Значение группы справочника, в которую переносится элемент справочника. |
Описание:
Вызов предопределенной процедуры ПриПереносеЭлементаВДругуюГруппу производится в системе 1С:Предприятие при интерактивном переносе элемента справочника в другую группу. Если в данной предопределенной процедуре установить статус возврата — 0, то перенос не будет произведен.
Данная предопределенная процедура может располагаться только в Модуле формы списка справочника (см. «Виды программных модулей»).
Пример:
Процедура ПриПереносеЭлементаВДругуюГруппу()
Если НазваниеНабораПрав() = "Продавец" Тогда
Предупреждение("У вас нет права менять группуi", 2);
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
Предопределенная процедура выбора родительской группы справочника.
Синтаксис:
ПриВыбореРодителя(<Элемент>)
Англоязычный синоним:
OnSetParent
Параметры:
|
<Элемент> |
Значение элемента справочника, который интерактивно устанавливается в качестве родителя. |
Описание:
Вызов предопределенной процедуры ПриВыбореРодителя производится в системе 1С:Предприятие при интерактивной смене родительской группы справочника (выбор следующего или предыдущего уровня). Если в данной предопределенной процедуре установить статус возврата — 0, то выбор родительской группы не будет произведен.
Данная предопределенная процедура может располагаться только в Модуле формы списка справочника (см. «Виды программных модулей»).
Пример:
Процедура ПриВыбореРодителя(Родитель)
Если НазваниеНабораПрав() = "Продавец" Тогда
Если Родитель = ЗапрещеннаяГруппа Тогда
Предупреждение("Вам запрещено просматривать эту группу!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
Предопределенная процедура выбора владельца подчиненного справочника.
Синтаксис:
ПриВыбореВладельца(<Элемент>)
Англоязычный синоним:
OnSetOwner
Параметры:
|
<Элемент> |
Значение элемента справочника, который интерактивно устанавливается в качестве владельца подчиненного справочника. |
Описание:
Вызов предопределенной процедуры ПриВыбореВладельца производится в системе ЮПредприятие при интерактивном выборе владельца подчиненного справочника (при интерактивной смене владельца, т. е. смене позиции в справочнике-владельце, которая приводит к смене отображаемых в подчиненном справочнике элементов). Если в данной предопределенной процедуре установить статус возврата — 0, то выбор владельца подчиненного справочника не будет произведен.
Данная предопределенная процедура может располагаться только в Модуле формы списка справочника (см. «Виды программных модулей»).
Пример:
Процедура ПриВыбореВладельца(Владелец)
Если НазваниеНабораПрав() = "Продавец" Тогда
Если Владелец = ЗапрещенныйВладелец Тогда
Предупреждение("Нельзя просматривать эти элементы!", 2);
СтатусВозврата(0);
КонецЕсли;
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
Предопределенная процедура смены режима отображения иерархии справочника.
Синтаксис:
ПриСменеИерархии(<Способ>)
Англоязычный синоним:
OnHierarchyChange
Параметры:
|
<Способ> |
Значение устанавливаемого (тот, который пользователь хочет установить) способа просмотра справочника: 1 — иерархических список; 0 — все элементы сразу. |
Описание:
Вызов предопределенной процедуры ПриСменеИерархии производится в системе 1С:Предприятие при интерактивной смене режима отображения иерархии справочника (пункт меню «Иерархический список»). Если в данной предопределенной процедуре установить статус возврата — 0, то смена режима отображения иерархии справочника не будет произведена.
Данная предопределенная процедура может располагаться только в Модуле формы списка справочника (см. «Виды программных модулей»).
Пример:
Процедура ПриСменеИерархии(ВыбСпособ)
Если НазваниеНабораПрав() = "Продавец" Тогда
Предупреждение("Нельзя менять режим просмотра 1", 2);
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
Предопределенная процедура при установке отбора справочника.
Синтаксис:
ПриУстановкеОтбора(<ТипОтбора>, <3начение0тбора>)
Англоязычный синоним:
OnSetSelectInJournal
Параметры:
|
<ТипОтбора> |
Строковое значение — тип устанавливаемого отбора (имя реквизита справочника по которому устанавливается отбор). |
|
<3начение0тбора> |
Устанавливаемое значение отбора. |
Описание:
Вызов предопределенной процедуры ПриУстановкеОтбора производится в системе 1С:Предприятие при интерактивной установке отбора любым способом (отбор, быстрый отбор, отбор по значению, история отбора) и при отключении отбора. Если в данной предопределенной процедуре установить статус возврата — 0, то установка отбора справочника не будет произведена.
Данная предопределенная процедура может располагаться только в Модуле формы списка справочника (см. «Виды программных модулей»).
Пример:
Процедура ПриУстановкеОтбора(ВыбСпособ)
Если НазваниеНабораПрав() = "Продавец" Тогда
Предупреждение("Нельзя устанавливать отбор;", 2);
СтатусВозврата(0);
КонецЕсли;
КонецПроцедуры
См. также: СтатусВозврата
