Удаляет все элементы из коллекции.
Синтаксис
Очистить()Полное описание, параметры и ограничения
ГруппаНастройкиСоставаИнтерфейсаКлиентскогоПриложения.Очистить (ClientApplicationInterfaceContentSettingsGroup.Clear)
ГруппаНастройкиСоставаИнтерфейсаКлиентскогоПриложения (ClientApplicationInterfaceContentSettingsGroup)
Очистить (Clear)
Доступен, начиная с версии 8.3.4.
Синтаксис:
Очистить()
Описание:
Удаляет все элементы из коллекции.
Доступность:
Сервер, толстый клиент.
Использование в версии:
Доступен, начиная с версии 8.3.4.
Методическая информация
Практические примеры
Упорядочить панели в собственной группе
На трёх стандартных панелях показываем вставку, индекс, сдвиг, удаление и очистку. Применения пользовательских настроек нет.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используйте собственную учебную базу и отдельного учебного пользователя, не рабочее приложение. Типы настроек доступны на сервере и в толстом клиенте, не непосредственно в обработчике тонкого клиента.
Создайте серверный общий модуль УчебныеЗадачи. Для уроков с готовыми процедурами/функциями вставьте полный код в модуль; для остальных — в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды собственной управляемой обработки.
Чтение и конструирование черновика не сохраняют пользовательские настройки. Только последний урок намеренно вызывает УстановитьСостав; для него нужна собственная конфигурация с именем УчебнаяКонфигурацияСинтаксиса и возможность восстановить настройки учебного пользователя вручную.
Группа = Новый ГруппаНастройкиСоставаИнтерфейсаКлиентскогоПриложения;
История = Новый ЭлементНастройкиСоставаИнтерфейсаКлиентскогоПриложения("ПанельИстории");
Избранное = Новый ЭлементНастройкиСоставаИнтерфейсаКлиентскогоПриложения("ПанельИзбранного");
Открытые = Новый ЭлементНастройкиСоставаИнтерфейсаКлиентскогоПриложения("ПанельОткрытых");
Группа.Добавить(История);
Группа.Добавить(Открытые);
Группа.Вставить(0, Избранное);
Сообщить(Группа.Количество() = 3);
Сообщить(Группа.Индекс(История) = 1);
Сообщить(Группа.Получить(0).Имя = "ПанельИзбранного");
Группа.Сдвинуть(2, -1);
Сообщить(Группа.Индекс(Открытые) = 1);
Сообщить(Группа.Получить(2).Имя = "ПанельИстории");
Группа.Удалить(0);
Сообщить(Группа.Количество() = 2);
Сообщить(Группа.Получить(0).Имя = "ПанельОткрытых");
Группа.Очистить();
Сообщить(Группа.Количество() = 0);Разбор по шагам
Сначала порядок История, Открытые. После Вставить(0, Избранное) порядок Избранное, История, Открытые.
Сдвинуть принимает индекс и смещение. Сдвинуть(2, -1) переносит Открытые на одну позицию к началу.
Удалить принимает индекс, не объект панели. После удаления 0 первым становится Открытые; старые индексы больше не подходят.
Очистить убирает элементы только собственной новой группы. Это не команда закрытия открытых форм и не очистка истории работы пользователя.
Как проверить результат
Восемь контрольных Истина; до очистки остаются Открытые и История.
Текущее окно, его история и открытые формы не изменились: менеджер настроек не используется.
Ожидаемый результат
Все восемь методов группы разобраны на контролируемом порядке собственных панелей.
На что обратить внимание
У группы интерфейса Сдвинуть принимает индекс; не переносите сюда перегрузку по объекту из коллекции действий поиска.
Очистить черновик группы и очистить реальную историю пользователя — совершенно разные операции.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.