Функции документов в iLogic

Используйте функции работы с документам для получения доступа к документу детали, сборки или чертежа Inventor. Функции работы с документами позволяют выполнять такие задачи, как извлечение имени файла и обновление модели.

В функциях работы с документами ThisDoc относится к документу Autodesk Inventor, в котором записано правило. Это часто активный документ, но он также может быть деталью сборки. Где бы ни хранилось правило, ThisDoc предоставляет доступ к этому документу.

Чтобы перейти к функциям работы с документами, разверните узел "Document" на вкладке "Система" в области "Фрагменты".

Path

Возвращает путь к документу (имя папки) в виде текстовой строки.

Синтаксис

ThisDoc.Path

FileName

Возвращает имя файла документа.

Синтаксис

ThisDoc.FileName(False)

Если в качестве аргумента указано значение False, расширение файла не включается. Чтобы использовать расширение файла, используйте в качестве аргумента значение True.

PathAndFileName

Возвращает имя файла документа и путь к нему.

Синтаксис

ThisDoc.PathAndFileName(False)

Если в качестве аргумента указано значение False, расширение файла не включается. Чтобы использовать расширение файла, укажите в скобках значение True.

ChangeExtension

Создает имя файла, используя имя файла документа и измененное расширение.

Синтаксис

changedName = ThisDoc.ChangeExtension(".new")

WorkspacePath

Возвращает путь (имя папки) к активному рабочему пространству проекта Autodesk Inventor. Если рабочее пространство не определено, эта функция возвращает пустую строку (строку, не содержащую символы, длина которой = нулю).

Синтаксис

ThisDoc.WorkspacePath()

Launch

Запускает файл по введенному имени файла (с расширением) и пути к нему. Если указан файл данных, он открывается в собственном приложении. Если указано исполняемый файл (.exe), запускается программа. Если полный путь не указан, iLogic ищет файл в папке, где расположен документ Inventor. Можно также указать относительное имя и путь к папке документа.

Синтаксис

ThisDoc.Launch("path\file.ext")

Save

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

Синтаксис

ThisDoc.Save

UpdateWhenDone

Обновляет документ, где расположено правило, после завершения выполнения правила (и любого из правил, которое оно запускает). Аналогичное обновление можно выполнить, щелкнув кнопку "Обновить" в интерфейсе пользователя.

Синтаксис

iLogicVb.UpdateWhenDone = True

RuleParametersOutput

Если правило изменило какие-либо значения параметров, эта функция применяет новые значения, полученные от правила, к модели Inventor. Если эта функция не используется, то значения применяются только после завершения выполнения правила. Используйте эту функцию, чтобы выполнить обновление с помощью DocumentUpdate. Эту функцию можно также использовать при использовании функции iLogicVb.RunRule, чтобы второе правило получило новые значения параметров.

Синтаксис

RuleParametersOutput()

DocumentUpdate

Выполняет немедленное обновление текущего документа (документа, в котором содержится это правило) и обновляет изображение. Используйте эту функцию, если необходимо перестроить геометрию (например, при вычислении массы с помощью iProperties.Mass). Если правило запускает другие правила (в результате изменения параметров), включите параметр Немедленно запустить зависимые правила для этого правила в диалоговом окне "Редактировать правило". Включение этого параметра обеспечивает завершение работы других правил при выполнении обновления.

Синтаксис

InventorVb.DocumentUpdate()

DocumentUpdate(False)

Выполняет немедленное обновление текущего документа (документа, в котором содержится это правило), не обновляя изображение документа. Функция InventorVb.DocumentUpdate обновляет не только модель, но и изображение. Чтобы не отображать результаты обновления, используйте вместо нее эту функцию.

Синтаксис

InventorVb.DocumentUpdate(False)

Обновить только изображение

Эта функция Inventor API обновляет только изображение, не обновляя модель.

Синтаксис

ThisApplication.ActiveView.Update()

CheckParameters

Проверяет значения параметров, не меняя никакие значения.

Используйте эту функцию в следующих ситуациях:

Предположим, параметры связаны с базовой деталью, а в базовой детали они связаны с внешней таблицей. Можно изменить значения параметров в таблице и сохранить ее, при этом эти изменения не будут отражаться в основной детали. Используйте эту функцию в правиле внутри основной детали до применения функции GoExcel для изменения значений в таблице. Эта функция обеспечивает загрузку базовой детали (на заднем фоне) и воспроизведение изменений во всей основной детали в сборке.

Синтаксис

InventorVb.CheckParameters("")

File Save As

Сохраняет документ с новым именем файла и при желании с новым расширением.

Синтаксис

ThisDoc.Document.SaveAs(NewFileNameAndExtension , True)

Истина

Присвойте значение True для выполнения операции "Сохранить копию как" или присвойте значение False для выполнения операции "Сохранить как".