Описанные в данном разделе методы доступны только в контексте Модуля формы элемента справочника (см. «Виды программных модулей»).
Возвратить признак изменения реквизитов в текущей форме элемента справочника.
Синтаксис:
Модифицированность()
Англоязычный синоним:
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
Параметры:
|
<ИмяОтбора> |
Строковое выражение — строка с именем реквизита справочника (по которому возможен отбор — флажок свойств «Отбор по реквизиту»), по которому установлен отбор. Если это значение пустое, то отбор отключается. |
| < |