Создает объект с ключем настройки. Также может быть создан с использованием функциональной формы оператора Новый.
Синтаксис
Новый ВыборНастроек(<КлючНастройки>)Полное описание, параметры и ограничения
ВыборНастроек.По умолчанию
ВыборНастроек (SettingsChoice)
На основании ключа
Доступен, начиная с версии 8.2.
Синтаксис:
Новый ВыборНастроек(<КлючНастройки>)
Параметры:
<КлючНастройки> (необязательный)
Тип: Произвольный.
Ключ настройки, устанавливаемый объекту.
Описание:
Создает объект с ключем настройки.
Также может быть создан с использованием функциональной формы оператора Новый.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Обычная форма загрузки настроек: вернуть выбранный действительный ключ
Настоящий выбор для вызывающего механизма загрузки.
Где и как запускать
Модуль своей обычной формы; толстый клиент.
Подготовка
Своя обычная форма, используемая подсистемой как форма загрузки настроек. КлючУчебногоВарианта — строковый реквизит с ключом реально сохраненного собственного варианта.
Вызывающий механизм должен загрузить настройки по возвращенному ВыборНастроек. Здесь нельзя подставлять выдуманный ключ рабочего хранилища.
Процедура ПодтвердитьЗагрузку()
Если ПустаяСтрока(КлючУчебногоВарианта) Тогда
ВызватьИсключение "Выберите свой существующий вариант";
КонецЕсли;
Выбор = Новый ВыборНастроек(КлючУчебногоВарианта);
ЭтотОбъект.Закрыть(Выбор);
КонецПроцедурыРазбор по шагам
Выберите действительный собственный ключ.
Создайте результат выбора.
Закройте форму с этим результатом.
Как проверить результат
Сопоставьте ключ с существующей собственной настройкой.
При отказе возвращайте Неопределено, не пустую фиктивную настройку.
Ожидаемый результат
Настоящий выбор для вызывающего механизма загрузки.
На что обратить внимание
Пример не запускался в 1С. Используйте только свои подготовленные элементы; имена элементов в коде должны совпадать с редактором формы.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Обычная форма сохранения настроек: вернуть настоящий выбор
Форма возвращает выбор, но сама не объявляет настройки сохраненными.
Где и как запускать
Модуль своей обычной формы; толстый клиент.
Подготовка
Создайте свою обычную форму выбора настроек для использования как форма сохранения в собственной подсистеме. Назначьте кнопку этой процедуре.
Это возврат объекта ВыборНастроек потребителю. Реальное сохранение должен выполнять настроенный вызывающий механизм; строка ключа относится только к своему учебному варианту.
Процедура ПодтвердитьСохранение()
Выбор = Новый ВыборНастроек("Учебный вариант");
Выбор.ДополнительныеСвойства.Вставить("Представление", "Мой учебный вариант");
Сообщить("Выбран собственный ключ: " + Строка(Выбор.КлючНастроек));
ЭтотОбъект.Закрыть(Выбор);
КонецПроцедурыРазбор по шагам
Создайте настоящий ВыборНастроек со своим ключом.
Добавьте собственное представление.
Закройте форму, передав выбор вызывающей стороне.
Как проверить результат
Проверьте тип возвращенного результата в своем вызывающем коде.
Отмену реализуйте отдельно Закрыть(Неопределено), не выдавая ее за сохранение.
Ожидаемый результат
Форма возвращает выбор, но сама не объявляет настройки сохраненными.
На что обратить внимание
Пример не запускался в 1С. Используйте только свои подготовленные элементы; имена элементов в коде должны совпадать с редактором формы.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.