O iLogic fornece regra de funções para configurar ou receber o iProperties de documentos de peça, montagem e desenho do Inventor. As regras são utilizadas para morph ou modificar projetos em novas configurações, manter os iProperties dos documentos de projeto atualizados. Os iProperties devem estar atualizados para que a lista de materiais esteja certa. As regras também podem ser utilizadas para ler os valores de iProperties de um documento e reagir a eles. Por exemplo, é possível ter uma regra que altera a espessura de uma peça quando a propriedade de material é alterada. Uma regra pode causar alterações se a massa da peça exceder o máximo ou mínimo. Qualquer iProperty que pode ser definido manualmente pode ser definido ou lido utilizando a regra.
Para acessar as funções de iProperty, expanda o nó iProperty na guia Sistema na área de trechos.
Sintaxe
iProperties.Value("guia nome da propriedade", "nome da propriedade" )
Lê ou define um valor de propriedade no documento que contém a regra.
iProperties.Value("filename.ipt", "guia nome da propriedade", "nome da propriedade" )
Utilizado em uma regra de nível de montagem para acessar o iProperties de uma peça ou submontagem.
Se o nome do arquivo da peça ou submontagem é alterado, o texto da regra também deve ser alterado.
O melhor é utilizar o nome do componente (após personalizá-la) ao invés do nome do arquivo.
iProperties.Value( "nome de componente personalizado", "guia nome da propriedade", "nome da propriedade" )
Define ou lê os valores de propriedade em um componente. Esta função utiliza o nome do componente ao invés do nome do arquivo. Personalize o nome do componente (alterá-lo em seu nome padrão original) para que ele não altere se a referência de arquivo alterar.
Exemplos
Definir o valor do iProperty:
iProperties.Value("Project", "Stock Number") = "302A"
Ler o valor do iProperty:
MyStringParam = iProperties.Value("Project", "Stock Number")
Definir o valor do iProperty padrão:
iProperties.Value("Custom", "Age") = 41 'number type
iProperties.Value("Custom", "Company") = "Autodesk, Inc" 'text type
iProperties.Value("Custom", "Date") = CDate("11/1/2008") ' date type
iProperties.Value("Custom", "Insured") = true 'yes or no type
Ler o valor do iProperty padrão:
age = iProperties.Value("Custom", "Age")
company = iProperties.Value("Custom", "Company")
thedate = CStr(iProperties.Value("Custom", "Date"))
insured = iProperties.Value("Custom", "Insured")
Coisas para lembrar
Work_In_Progress = 1
Pending = 2
Released = 3
iProperties.Value("Status", "Design State") = Pending
Funções depreciadas
Versões anteriores de iLogic utilizaram as seguintes funções para pegar os iProperties de peças em montagens:
iProperties.ValueInDoc("filename.ipt", "guia nome da propriedade", "nome da propriedade" )
Faz referência ao nome do arquivo.
iProperties.ValueInComponent("nome do componente personalizado", "guia nome da propriedade", "nome da propriedade")
Faz referência ao nome do componente.
Embora estas funções não estão disponíveis na área de trechos da caixa de diálogo Editar regra, elas funcionam se forem utilizados em uma regra. Entretanto, a funçãoiProperties.Value é preferível, ao invés destas funções mais antigas.
Esta função suporta a utilização do mesmo documento em diferentes versões de idiomas do Autodesk Inventor. Seu modelo é mais portátil quando utilizar nomes em inglês para os materiais e cores em suas regras. Se esta função for configurada para Verdadeira, então qualquer função que retornar qualquer material nome de cor retornará os nomes em inglês. É possível utilizar nomes no idioma de sua instalação do Autodesk Inventor para definir um nome de material ou cor. Mas é recomendado que utilize nomes em inglês para a consistência. As seguintes funções retornam nomes em inglês quando for configurado o valor iProperties.StyleInEnglish para Verdadeiro:
Define ou lê o material de um documento.
Ao definir o material, utilize o nome de material exato (maiúsculas e minúsculas) como aparece na lista de materiais físicos padrão ativa. Os valores de material são sempre sequências de texto, entre aspas.
Exemplos
Para definir o material:
iProperties.Material = "Gold"
Para ler o material:
MyStringParam = iProperties.Material
Lê ou define o material de uma peça em uma montagem, especificando o nome do arquivo.
Utilizado em uma regra de nível de montagem para acessar o material de uma peça na montagem, especificando o nome do componente.
Define ou lê a cor atual de uma peça. Os valores de cor de peça são sequências de texto entre aspas. Alterar a cor não afeta o valor de material atual.
Esta função funciona somente para peças.
Exemplos
Para definir a cor:
iProperties.PartColor = "Green" iProperties.PartColor = "As Material"
Para ler a cor:
MyStringParam = iProperties.PartColor
Lê ou grava a massa do documento de peça ou montagem contendo a regra.
Se gravar para a massa, ela substitui a massa calculada. Para restaurar o valor calculado, defina a massa para -1.
iProperties.Mass("nome_do_arquivo.ipt")
Lê ou grava a massa de uma peça ou submontagem em uma montagem, especificando o nome do arquivo.
iProperties.Mass("nome do componente:1")
Lê ou grava a massa de um componente em uma montagem, especificando o nome do componente. Esta função também pode ser utilizada para ler ou gravar para a massa de um componente virtual.
Exemplos
Para ler a massa:
MyMassParam = iProperties.Mass
MyMassParam = iProperties.Mass("component:1")
MyMassParam = iProperties.Mass("mypart.ipt")
Para definir a massa (substituir cálculo automático):
iProperties.Mass = 3 kg
iProperties.Mass("virtual_component") = 233 g
iProperties.Mass("mypart.ipt") = 4.2 lb
massiProperties.Mass = -1 'set the mass back to automatic calculation
Lê ou grava o volume do documento contendo a regra.
iProperties.Volume("nome_do_arquivo.ipt")
Lê ou grava o volume da peça ou submontagem contendo a regra, especificando o nome do arquivo.
iProperties.Volume("componente:1")
Lê ou grava o volume de um componente em uma montagem, especificando o nome do componente. Esta função também pode ser utilizada para ler ou gravar para o volume de um componente virtual.
Exemplos
Para ler o volume:
MyVolumeParam = iProperties.Volume
MyVolumeParam = iProperties.Volume("component:1")
MyVolumeParam = iProperties.Volume("mypart.ipt")
Para definir o volume (substituir cálculo automático):
iProperties.Volume = 12.4 in^3
iProperties.Volume("virtual_component") = 542 cm^3
iProperties.Volume("mypart.ipt") = 12.8 in^3
iProperties.Volume = -1 'set it back to automatic calculation
Lê o centro da gravidade do modelo no documento contendo a regra.
Sintaxe
pt = iProperties.CenterOfGravity
pt é do tipo Inventor.Point, que é descrito na Ajuda para Inventor API. É possível ler os valores X, Y e Z do ponto, expresso nas unidades do documento de regra:
cx = pt.X cy = pt.Y cz = pt.Z
pt = iProperties.CenterOfGravity ("componente")
Lê o centro da gravidade de um componente em uma montagem, especificando o nome do componente.
Lê a área de superfície do modelo no documento contendo a regra.
Sintaxe
surfaceArea = iProperties.Area
surfaceArea = iProperties.Area("componente:1")
Lê a área de superfície de um componente em uma montagem, especificando o nome do componente.