Студия/OnLoadSettings

OnLoadSettings (Визуальные события)
Применимость: Форма Тип события: Прерывающее Статус разработки: Реализована

• Начальная страница
• Редактор форм
• Визуальные события

Событие, возникающее до автоматической (либо по требованию пользователя) загрузки установок формы из файла установок на сервере. В понятие установок входят значения полей редактирования, флажков, тегов, позиций таблиц и пр. Автоматическая загрузка установок производится только для форм с флажком IsAutoSaveLoadSettings. Элементы, входящие в файл установок, должны иметь непустое поле Name (позиции таблиц и теги также загружаются для любых элементов, связанных с базой данных).

Аргументы

• <SetName (STRING)> - Переменная задает наименование файла установок (к примеру, Default.set). Если при вызове события наименование файла заполнено, происходит автоматическая загрузка установок без участия пользователя (к примеру, при открытии формы), если аргумент содержит пустую строку, ожидается вывод диалога, чтобы пользователь смог выбрать файл установок самостоятельно.
• <FolderName (STRING)> - Переменная задает наименование папки (формируется из идентификатора объекта или имени папки метаданных) из которой будет происходить чтение установок (к примеру, UserSettings\<Имя пользователя>\Справочник.Номенклатура\Form).
• <Result> - (возможен аргумент-переменная (ByRef)) Переменная результата может принимать значения:
  • 0 (по умолчанию) -- Разрешить загрузку установок
  • 1 -- Запретить загрузку установок

Примеры

//Пример события OnLoadSettings, установки читаются нестандартным образом
Result:=1;
if not Form.IsFullyInitialized() then
  Exit;
EndIf;
if isEmpty(SetName) Then
  If not SelectFormSettingsFile(0,FolderName,SetName) Then
    Exit;
  EndIf;
EndIf;
спОтбор:=ObjectFromFile(AddBackSlash(FolderName)+SetName);
ПрименитьУстановки();