Пособие по COM в Мастере функций nanoCAD BIM Строительство. Часть 2
19 ноября 2026
Олег Ачкасов
Олег Ачкасов
инженер САПР ООО «Макссофт-24» E-mail: oleg@maxsoft.ru

В первой части статьи мы познакомились с доступными API, отдельно рассмотрели COM API применительно к nanoCAD BIM Строительство, а также сформулировали его достоинства и недостатки. В этой статье разберем работу с COM-интерфейсом через Мастер функций и рассмотрим несколько готовых запросов для решения практических задач.

Диалоговое окно Мастера функций

Доступ к COM-запросам осуществляется через отдельное диалоговое окно Мастер функций. Чтобы открыть его, выберите параметр, который требуется отредактировать, затем последовательно нажмите Редактировать комментарий и Вставить функцию (рис. 1).

Рис. 1 Открытие Мастера функций для выбранного параметра

Сам по себе Мастер функций, даже без COM-интерфейса, обладает широкими возможностями. Он позволяет создавать составные выражения с использованием параметров объектов, логических и математических операторов, промежуточных переменных и других функций. COM-обращения дополняют эти возможности и позволяют взаимодействовать с объектами модели.

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

Рис. 2 Различные операторы в Мастере функций
Рис. 3 Различные операторы в Мастере функций
COM интерфейс в Мастере функций
Рис. 4 Выбор COM-запроса в Мастере функций

В разделе COM-запросов выбирают нужный объект и доступные для него свойство или метод (рис. 4). Выбранное обращение вставляется в формулу в позицию курсора.

Практические приемы
Отслеживание параметров проекта CADLib в объектах nanoCAD BIM Строительство

В этом разделе приведены COM-запросы, которые позволяют получить в объектах nanoCAD BIM Строительство сведения о текущих переменных и атрибутах иерархий CADLib. Их можно использовать для кодирования элементов по кодам иерархий CADLib и для отслеживания текущих переменных, если в одной публикации у объектов заданы разные значения.

Для удобства отслеживания и заполнения текущих переменных с помощью Менеджера библиотек добавим пользовательские атрибуты в категорию Текущие переменные: Раздел проекта, Шифр проекта и Ситуация по ЗиС (рис. 5). Для них зададим тип значения Расчетный, а в поле Комментарий введем формулы, вычисляющие текущие переменные проекта. После этого готовые атрибуты можно добавлять к элементам модели (рис. 6).

Рис. 5 Создание расчетных атрибутов текущих переменных в Менеджере библиотек

Обращение типа hierarchy("<имя иерархии>").Element.name возвращает имя последнего узла иерархии, заданного в текущих переменных объекта. Обращение не работает для иерархии Project.

Рис. 6 Добавление пользовательских атрибутов к объекту в nanoCAD BIM Строительство
Рис. 7 Значения текущих переменных в параметрах объекта

После назначения текущих переменных объектам модели можно отследить работу СОМ-запросов как в свойствах, так и после публикации в окне связей в CADLib Модель и Архив (рис. 8).

Рис. 8 Текущие переменные объекта в CADLib Модель и Архив

Вместо слов <имя иерархии> в формулу необходимо подставить обозначение нужной иерархии CADLib Модель и Архив. Ниже перечислены имена иерархий. В примерах показаны узлы, имена и параметры которых считываются формулами.

  • Discipline – иерархия раздела проекта;
  • Project — свойства главного узла иерархии проекта;
  • Building — подраздел иерархии проекта. Если конструкции или системы не заданы, информация берется из ЗиС на уровне здания;
  • Building_situation — иерархия ЗиС, подраздел иерархии проекта, который задает узлы по ситуации;
  • Structure — пользовательская произвольная иерархия структуры.

В случае, если необходимо получить единый шифр по ситуации и системам, формула будет выглядеть следующим образом:

=string(hierarchy("Building_situation").Element.Parameters["CLP_FULL_CODE"])&

"."&(if(count(split(string(hierarchy("Building").Element.Parameters["CLP_FULL_CODE"]),"."))=2,"", (string(hierarchy("Building").Element.Parameters["CLP_FULL_CODE"]) \

(split(string(hierarchy("Building").Element.Parameters["CLP_FULL_CODE"]), ".")[0]&

"."&

split(string(hierarchy("Building").Element.Parameters["CLP_FULL_CODE"]), ".")[1]&

"."))))

Использование такой формулы в свойствах позволяет определить, что опубликованный в примере объект относится к:

  • стройплощадке;
  • зданию;
  • этажу;
  • помещению;
  • разделу;
  • подразделу.

Для удобства и наглядности можно создать отдельный шаблон спецификатора, в котором можно отслеживать как заполняемость, так и привязки элементов модели к текущим переменным проекта (рис. 9).

Рис. 9 Спецификатор как визуализация текущих переменных

Помимо этого, есть возможность передавать параметры проекта в объект, предварительно заполнив сведения о проекте в CADLib или nanoCAD BIM Строительство (рис. 10).

Рис. 10 Обращение к параметру проекта из формулы

hierarchy("<имя иерархии>").Element.Parameters["<имя атрибута>"] возвращает значение атрибута последнего узла иерархии, заданного в текущих переменных. Обращение работает для иерархии Project. Пример использования показан на рис. 11.

Рис. 11 Параметр проекта в CADLib Модель и Архив
Связь атрибутивных и геометрических свойств объектов

В следующем примере рассмотрим ассоциацию параметров с помощью COM-интерфейса. Прием показан в обобщенном виде, однако, связь атрибутивных и геометрических свойств можно настраивать под конкретную задачу. В стандартном функционале программы есть и готовые связи между объектами: с помощью механизма Диспетчера марок или команды NBIM_ASSOCIATE Ассоциировать объекты. Но мы рассмотрим ручную ассоциацию параметров на примере синхронизации объектов, представляющих задание на проем в теле перекрытия.

Перед созданием ассоциации необходимо узнать уникальный идентификатор handle-объекта, из которого будут скопированы параметры. Для этого используется выражение object.handle (рис. 12).

Рис. 12 Получение идентификатора handle исходного объекта
Рис. 13 Обращение к параметру объекта по идентификатору handle

application.ActiveDocument.HandleToObject("E79").Element.Parameters.Item("DIM_HEIGHT").Value

application.ActiveDocument.HandleToObject("Идентификатор\handle").Element.Parameters.Item("параметр").Value,

где:

  • application — запущенное приложение nanoCAD BIM Строительство;
  • ActiveDocument — открытый в данный момент файл *.dwg;
  • HandleToObject — обращение к объекту по уникальному идентификатору handle в рамках файла *.dwg;
  • параметр — имя атрибута, значение которого необходимо скопировать.

Скопированные объекты уровня 2 и выше будут геометрически ассоциированы с базовым объектом. В данном примере это позволяет сохранять корректное положение отверстий. Чтобы обновить значения атрибутов, смените LOD в строке состояния.

Обращение к параметрам дочерних элементов

COM-интерфейс позволяет получать параметры не только корневого объекта (root), но и его дочерних элементов (child). Для обращения к дочернему элементу используйте запрос: application.ActiveDocument.HandleToObject («Идентификатор\handle»).Element.SubElements.Item («Имя дочернего объекта\child»). Parameters.Item(«параметр»).Value

Если структура объекта имеет дополнительный уровень вложенности, добавьте еще одно обращение к SubElements: application.ActiveDocument.HandleToObject(«Идентификатор\handle»).Element.SubElements.Item(«Имя дочернего объекта\child»).SubElements.Item(«Имя подобъекта дочернего объекта\child1_2»).Parameters.Item(«параметр»).Value

Ниже показана ассоциация материалов отделки на примере двух лестничных маршей (рис. 14).

Рис. 14 Ассоциация параметров дочерних элементов лестничных маршей
Вычисление ошибок при моделировании

СОМ-запросы могут учитывать не только атрибуты, но и геометрические свойства объекта. В следующем примере сравниваются координаты начальной и конечной точек металлопроката. Если объект находится под углом, то выражение задает изменение цвета объекта. Если же объект находится ортогонально, то цвет не меняется и задает выражение 0 (рис. 16).

if((vector(object.EndPoint)[0] <> vector(object.StartPoint)[0] or vector(object.EndPoint)[1] <> vector(object.StartPoint)[1]) and

vector(object.EndPoint)[2] <> vector(object.StartPoint)[2],

150, 0)

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

Рис. 15 Формула с проверкой координат объекта
Рис. 16 Результат применения формулы к объектам с разной ориентацией
Заключение

COM-интерфейс расширяет возможности nanoCAD BIM Строительство и позволяет обращаться не только к параметрам текущего объекта, но и к данным проекта, иерархиям CADLib, параметрам осевых, другим объектам модели.

Рассмотренные примеры показывают, как передавать проектные параметры в элементы модели, связывать атрибутивные и геометрические свойства объектов и формировать значения с учетом их положения. Эти приемы можно адаптировать к конкретным задачам и использовать исходя из ваших условий разработки и ведения информационной модели в nanoCAD BIM Строительство.

Оцените nanoCAD BIM Строительство в работе.

В течение бесплатного 30-дневного пробного периода доступны все возможности продукта. 

Этот сайт использует cookies. Пользуясь сайтом, вы даете согласие на обработку ваших персональных данных. Подробнее