Funções de documento no iLogic

Utilize as funções de documento para acessar documento de peça, montagem ou desenho do Inventor. As funções de documento permite que execute tarefas como obter o nome do arquivo e atualizar o modelo.

Em funções de Documento, Thisdoc se refere ao documento do Autodesk Inventor onde a regra é gravada. Ele é muitas vezes o documento ativo, mas também pode ser uma peça dentro de uma montagem. Aonde quer que a regra esteja armazenada, ThisDoc fornece acesso àquele documento.

Para acessar as funções de documento, expanda o nó Documento na guia Sistema na área de trechos.

Path

Retorna o caminho do documento (nome da pasta) como uma sequência de texto.

Sintaxe

ThisDoc.Path

FileName

Retorna o nome do arquivo do documento.

Sintaxe

ThisDoc.FileName(Falso )

A extensão de arquivo não está incluída quando Falso é fornecido como um argumento. Se deseja a extensão de arquivo, substitua Verdadeiro como o argumento.

PathAndFileName

Retorna o caminho e nome do arquivo do documento.

Sintaxe

ThisDoc.PathAndFileName(Falso )

A extensão de arquivo não está incluída quando Falso é fornecido como um argumento. Para incluir a extensão de arquivo, substitua Verdadeiro dentro dos parênteses.

ChangeExtension

Cria um nome do arquivo utilizando o nome do arquivo do documento e uma extensão alterada.

Sintaxe

changedName = ThisDoc.ChangeExtension( ".new” )

WorkspacePath

Retorna o caminho (nome da pasta) do espaço de trabalho do projeto de Autodesk Inventor ativo Se não há espaço de trabalho definido, esta função retorna uma sequência vazia (uma sequência sem caracteres, com comprimento = zero). Se não há espaço de trabalho definido, esta função retorna uma sequência vazia (uma sequência sem caracteres, com comprimento = zero).

Sintaxe

ThisDoc.WorkspacePath( )

Launch

Inicia um arquivo com base no caminho e nome do arquivo (incluindo extensão) fornecido. Se um arquivo de dados é especificado, ele abre no seu aplicativo nativo. Se um arquivo executável (.exe) é especificado, ele executa o programa. Se não especificar um caminho completo, o iLogic procura pelo arquivo na mesma pasta que o documento do Inventor. Também é possível especificar um nome relativo e caminho para a pasta de documento.

Sintaxe

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

Save

Salva o documento ativo atualmente. Esta função não funciona em uma regra desencadeada por um evento de alteração de parâmetro.

Sintaxe

ThisDoc.Save

UpdateWhenDone

Atualiza o documento onde a regra está dentro, depois que a regra (e qualquer regra que ele desencadear) acaba de ser executada. Esta atualização é a mesma que clicar no botão Atualizar na interface do usuário.

Sintaxe

iLogicVb.UpdateWhenDone = Verdadeiro

RuleParametersOutput

Se sua regra alterou qualquer valor de parâmetro, esta função aplica novos valores de regra ao modelo do Inventor. Se esta função não é utilizada, as regras não são aplicadas até que a regra acabe de ser executada. Utilize esta função se precisar executar uma Atualização utilizando Atualização de Documentos Utilize também esta função se estiver utilizando a iLogicVb.RunRule função, para que as outras regras obtenham novos valores dos parâmetros.

Sintaxe

RuleParametersOutput ()

DocumentUpdate

Executa uma atualização imediata no documento atual (o documento onde se localiza a regra) e atualiza a exibição. Utilize esta função se necessitar que a geometria seja reconstruída (por exemplo, está calculando a massa utilizando iProperties.Mass). Se a regra executa outras regras (alterando os parâmetros), ative a opção Regras dependentes de execução imediatamente para a regra na caixa de diálogo Editar Regra. Esta opção assegura que as outras regras já acabaram de ser executadas quando executar a atualização.

Sintaxe

InventorVb.DocumentUpdate( )

DocumentUpdate(False)

Executa uma atualização imediata no documento atual (o documento onde se localiza a regra) sem atualizar a exibição do documento. A função InventorVb.DocumentUpdate atualiza a exibição ao mesmo tempo que o modelo. Se não quiser que a exibição atualize, utilize esta função em vez disso.

Sintaxe

InventorVb.DocumentUpdate(Falso)

Exibir somente atualização

Esta função API do Inventor atualiza somente a exibição, e não o modelo.

Sintaxe

ThisApplication.ActiveView.Update()

CheckParameters

Verifica os valores de parâmetros mas não altera nenhum valor.

Utilize esta função em situações como a seguinte:

Suponha que os seus parâmetros estão vinculados a uma peça de base, e na peça de base eles estão vinculados a uma planilha externa. É possível alterar os valores dos parâmetros na planilha e salvá-la sem estas alterações aparecendo na peça principal. Utilize esta função em uma regra na peça principal antes de utilizar GoExcel para alterar valores na planilha. Esta função garante que a peça base é carregada (no plano de fundo) e que as alterações se propaguem até a peça principal da montagem.

Sintaxe

InventorVb.CheckParameters(“”)

File Save As

Salva o documento com um novo nome do arquivo e, opcionalmente, uma nova extensão.

Sintaxe

ThisDoc.Document.SaveAs(NewFileNameAndExtension, Verdadeiro)

Verdadeiro

Definir para Verdadeiro para executar uma operação Salvar Cópia Como, ou definir para Falso para executar uma operação Salvar Como.