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