ADN Open CIS
Сообщество программистов Autodesk в СНГ

Как получить все доступные параметры экземпляра для категории

Получить все параметры заданной категории можно двумя способами.

Первый заключается в том, что нужно получить объект в модели заданной категории и взять его коллекцию параметров. Например, вот так:

В результате будет выведено следующее в окно Output:

Преимущества данного подхода:

• Отображаются только те свойства, которые видны пользователю, в окне свойств объекта
• Можно получить группу параметра

Недостатки:

• Объект данной категории обязательно должен присутсвовать в модели.

Еще один способ – использование метода ParameterFilterUtilities.GetFilterableParametersInCommon(Document doc, ICollection<ElementId> categories). Метод возвращает идентификаторы параметров, доступных для фильтрации элементов по выбранным категориям. В интерфейсе пользователя, это можно увидеть, например при создании фильтра видимости элементов:

Т.е. чтобы получить список параметров, доступных одной категории, то нужно вторым параметром передать коллекцию, состоящую из одной, тербуемой категории.

Так как результат возвращается в виде идентификатора, то чтобы получить название параметра, нужно допольнительное преобразование.

Для встроенного параметра, нужно воспользоваться методом LabelUtils.GetLabelFor(BuiltInParameter):

В случае же общего параметра, или параметра проекта, нужно сначала получить элемент, по этому идентификатору, а затем получить его название:

Результат:

Не трудно заметить, что параметров в этом списке немного больше. Часть параметров являются параметрами типа, так как в фильтрации возможно использовать и их.

Преимущества способа:

• Вомзожно получить параметры катеогрии объекта, даже если самого объекта в модели нет.

Недостатки:

• Возвращаются «лишние» параметры. Нет разграничения на параметры типа и экземпляра
• Нельзя получить группу

Оба способа имеют свои преимущества и недостатки. Недостатки одного, компенсируются преимуществами другого. Какой способ использовать – зависит от ситуации и задачи. Возможно оптимальным будет использование обоих способов одновременно.