Funciones de iProperties en iLogic

iLogic ofrece funciones de regla para configurar u obtener las iProperties de los documentos de pieza, de ensamblaje y de dibujo de Inventor. Ya que las reglas se utilizan para transformar o modificar los diseños con nuevas configuraciones, mantienen las iProperties de los documentos de diseño actualizadas. Las iProperties deben estar actualizadas para que la lista de materiales sea correcta. Las reglas pueden utilizarse también para leer los valores de iProperty de un documento y reaccionar a ellos. Por ejemplo, puede tener una regla que cambie el grosor de una pieza cuando se cambie la propiedad de material. Una regla puede ocasionar cambios si la masa de la pieza excede un máximo o un mínimo. Las iProperties que se pueden definir manualmente se pueden configurar o leer mediante una regla.

Para acceder a las funciones de iProperties, expanda el nodo iProperties en la ficha Sistema del área Fragmentos.

iProperties.Value

Sintaxis

iProperties.Value("nombre de la ficha de propiedades", "nombre de propiedad")

Lee o define el valor de una propiedad en el documento que contiene la regla.

iProperties.Value("nombre de archivo.ipt", "nombre de la ficha de propiedades", "nombre de propiedad")

Se utiliza en reglas de nivel de ensamblaje para acceder a las iProperties de una pieza o un subensamblaje.

Si el nombre de archivo de la pieza o el subensamblaje se modifica, el texto de la regla también se debe cambiar.

Se recomienda utilizar el nombre de componente (tras personalizarlo) en lugar del nombre de archivo.

iProperties.Value("nombre del componente personalizado", "nombre de la ficha de propiedades", "nombre de propiedad")

Establece o lee los valores de las propiedades de un componente. Esta función utiliza el nombre de componente en lugar del nombre de archivo. Personalice el nombre de componente (cambie su nombre por defecto original) para que no cambie si la referencia del archivo cambia.

Ejemplos

Definir el valor de la iProperty:

iProperties.Value("Project", "Stock Number") = "302A"

Leer el valor de la iProperty:

MyStringParam = iProperties.Value("Project", "Stock Number")

Definir el valor de la iProperty personalizada:

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

Leer el valor de la iProperty personalizada:

age = iProperties.Value("Custom", "Age")
company = iProperties.Value("Custom", "Company")
thedate = CStr(iProperties.Value("Custom", "Date"))
insured = iProperties.Value("Custom", "Insured")

Cosas que recordar

Funciones obsoletas

Las versiones anteriores de iLogic utilizaban las siguientes funciones para obtener las iProperties de piezas de ensamblajes:

iProperties.ValueInDoc("nombre de archivo.ipt", "nombre de la ficha de propiedades", "nombre de propiedad")

Hace referencia al nombre de archivo.

iProperties.ValueInComponent("nombre del componente personalizado", "nombre de la ficha de propiedades", "nombre de propiedad")

Hace referencia al nombre de componente.

Aunque estas funciones no están disponibles en el área Fragmentos del cuadro de diálogo Editar regla, funcionan si se utilizan en una regla. Sin embargo, es preferible utilizar la función iProperties.Value en lugar de estas funciones anteriores.

iProperties.StylesInEnglish

Esta función permite el uso del mismo documento en las versiones de Autodesk Inventor en distintos idiomas. El modelo es más transferible cuando se utilizan nombres en inglés para los materiales y colores de las reglas. Si se establece esta función en True, cualquier función que devuelva algún material o nombres de color devuelve los nombres en inglés. Puede utilizar nombres en el idioma de instalación de Autodesk Inventor para definir un material o nombre de color. Sin embargo, se recomienda utilizar nombres en inglés para mantener la coherencia. Las siguientes funciones devuelven nombres en inglés al establecer el valor de iProperties.StylesInEnglish como True:

iProperties.Material

Define o lee el material de un documento.

Al definir el material, utilice el nombre exacto de material (teniendo en cuenta mayúsculas y minúsculas) que aparece en la lista de materiales físicos de la norma activa. Los valores de material siempre son cadenas de texto y van entre comillas.

Ejemplos

Para definir el material:

iProperties.Material = "Gold"

Para leer el material:

MyStringParam = iProperties.Material

iProperties.Material(“filename.ipt”)

Establece o lee el material de la pieza de un ensamblaje especificando el nombre de archivo.

iProperties.Material(“componentName:1”)

Se utiliza en una regla de nivel de ensamblaje para acceder al material de una pieza del ensamblaje especificando el nombre de componente.

iProperties.PartColor

Establece o lee el color actual de una pieza. Los valores de color de pieza son cadenas de texto que van entre comillas. El cambio de color no afecta al valor de material actual.

Esta función solo funciona con las piezas.

Ejemplos

Para definir el color:

iProperties.PartColor = "Green"
iProperties.PartColor = "As Material"

Para leer el color:

MyStringParam = iProperties.PartColor

iProperties.Mass

Lee o escribe la masa del documento de pieza o ensamblaje que contiene la regla.

Si escribe en la masa, se anula la masa calculada. Para restablecer el valor calculado, defina la masa en -1.

iProperties.Mass(“nombre de archivo.ipt”)

Lee o escribe la masa de una pieza o un subensamblaje de un ensamblaje especificando el nombre de archivo.

iProperties.Mass(“nombre de componente:1”)

Lee o escribe la masa de un componente de un ensamblaje especificando el nombre de componente. Esta función puede utilizarse también para leer o escribir en la masa de un componente virtual.

Ejemplos

Para leer la masa:

MyMassParam = iProperties.Mass
MyMassParam = iProperties.Mass("component:1")
MyMassParam = iProperties.Mass("mypart.ipt")

Para establecer la masa (anular el 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

iProperties.Volume

Lee o escribe el volumen del documento que contiene la regla.

iProperties.Volume(“nombre de archivo.ipt”)

Lee o escribe el volumen de la pieza o el subensamblaje que contiene la regla especificando el nombre de archivo.

iProperties.Volume(“componente:1”)

Lee o escribe el volumen de un componente de un ensamblaje especificando el nombre de componente. Esta función puede utilizarse también para leer o escribir en el volumen de un componente virtual.

Ejemplos

Para leer el volumen:

MyVolumeParam = iProperties.Volume
MyVolumeParam = iProperties.Volume("component:1")
MyVolumeParam = iProperties.Volume("mypart.ipt")

Para establecer el volumen (anular el 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

iProperties.CenterOfGravity

Lee el centro de gravedad del modelo en el documento que contiene la regla.

Sintaxis

pt = iProperties.CenterOfGravity

pt es del tipo Inventor.Point, que se describe en la Ayuda de la API de Inventor. Puede leer los valores X, Y y Z del punto, expresados en las unidades del documento de regla:

cx = pt.X
cy = pt.Y
cz = pt.Z

pt = iProperties.CenterOfGravity("componente")

Lee el centro de gravedad de un componente de un ensamblaje especificando el nombre de componente.

iProperties.Area

Lee el área de superficie del modelo en el documento que contiene la regla.

Sintaxis

Área de superficie = iProperties.Area

Área de superficie = iProperties.Area(“componente:1”)

Lee el área de superficie de un componente en un ensamblaje especificando el nombre de componente.