Utilice las funciones de documento para acceder al documento de pieza, ensamblaje o dibujo de Inventor.
Las funciones de documento permiten realizar tareas como obtener el nombre de archivo y actualizar el modelo.
En las funciones del documento, ThisDoc hace referencia al documento de Inventor en el que se escribe la regla. A menudo es el documento activo, pero también puede ser una pieza de un ensamblaje. Independientemente del lugar donde se guarde la regla, ThisDoc proporciona acceso al documento.
Para acceder a las funciones de documento, expanda el nodo Documento en la ficha Sistema del área Fragmentos del cuadro de diálogo Editar regla de iLogic.
Devuelve la ruta del documento (nombre de carpeta) como una cadena de texto.
Sintaxis
ThisDoc.Path
Devuelve el nombre de archivo del documento.
Sintaxis
ThisDoc.FileName(False)
La extensión del archivo no se incluye cuando se utiliza False como argumento. Si desea que se incluya la extensión de archivo, sustituya el argumento por True.
Devuelve la ruta y el nombre de archivo del documento.
Sintaxis
ThisDoc.PathAndFileName(False)
La extensión del archivo no se incluye cuando se utiliza False como argumento. Para incluir la extensión de archivo, sustituya el argumento entre paréntesis por True.
Crea un nombre de archivo con el nombre de archivo del documento y una extensión modificada.
Sintaxis
changedName = ThisDoc.ChangeExtension(“.new”)
Devuelve la ruta (nombre de carpeta) del espacio de trabajo del proyecto activo de Inventor. Si no hay ningún espacio de trabajo definido, esta función devuelve una cadena vacía (una cadena sin caracteres, con longitud = cero).
Sintaxis
ThisDoc.WorkspacePath()
Abre un archivo con base en la ruta y el nombre de archivo proporcionados (incluyendo la extensión). Si se especifica un archivo de datos, éste se abre en su aplicación original. Si se especifica un archivo ejecutable (.exe), éste ejecuta el programa. Si no se especifica una ruta completa, iLogic busca el archivo en la misma carpeta que el documento de Inventor. También puede especificar un nombre y una ruta relativos a la carpeta del documento.
Sintaxis
ThisDoc.Launch(“path\file.ext”)
Guarda el documento activo actual. Esta función no funciona en reglas activadas por un evento de cambio de parámetro.
Sintaxis
ThisDoc.Save
Actualiza el documento en el que se encuentra la regla cuando ésta (y las reglas que ésta active) termine de ejecutarse. Esta actualización es la misma que cuando se hace clic en el botón Actualizar de la interfaz de usuario.
Sintaxis
iLogicVb.UpdateWhenDone = True
Si la regla ha cambiado algún valor de parámetro, esta función aplica nuevos valores de regla al modelo de Inventor. Si no se utiliza esta opción, los valores no se aplicarán hasta que la regla haya terminado de ejecutarse. Utilice esta función si debe realizar una actualización usando DocumentUpdate. Utilice esta función también cuando haga uso de la función iLogicVb.RunRule para que la otra regla obtenga los nuevos valores de los parámetros.
Sintaxis
RuleParametersOutput()
Realiza una actualización inmediata en el documento actual (el documento en el que está la regla) y actualiza la visualización. Utilice esta función si precisa que se regenere la geometría (por ejemplo si calcula la masa mediante iProperties.Mass). Si la regla activa otras reglas (mediante el cambio de parámetros), active la opción Activar reglas dependientes inmediatamente en la regla desde el cuadro de diálogo Editar regla. Esta opción garantiza que las otras reglas hayan terminado de ejecutarse en el momento en el que se realiza la actualización.
Sintaxis
InventorVb.DocumentUpdate()
Realiza una actualización inmediata en el documento actual (el documento en el que está la regla) sin actualizar la visualización del documento. La función InventorVb.DocumentUpdate actualiza la visualización, así como el modelo. Si no desea que se actualice la visualización utilice esta función.
Sintaxis
InventorVb.DocumentUpdate(False)
Esta función API de Inventor actualiza únicamente la visualización, y no el modelo.
Sintaxis
ThisApplication.ActiveView.Update()
Comprueba los valores de parámetro, pero no cambia ninguno de los valores.
Utilice esta función en situaciones como las siguientes:
Supongamos que los parámetros están vinculados a una pieza base y, en la pieza base, están vinculados a una hoja de cálculo externa. Se pueden cambiar los valores de parámetro en la hoja de cálculo y guardarla sin que esos cambios aparezcan en la pieza principal. Utilice esta función en una regla de la pieza principal antes de utilizar GoExcel para cambiar los valores en la hoja de cálculo. Esta función garantiza que la pieza base se cargue (en segundo plano) y que los cambios se propaguen por la pieza principal del ensamblaje.
Sintaxis
InventorVb.CheckParameters(“”)
Guarda el documento con un nombre de archivo nuevo y, si se desea, con una extensión distinta.
Sintaxis
ThisDoc.Document.SaveAs(NewFileNameAndExtension , True)
True
Establézcalo en True para realizar una operación de Guardar copia como o en False para realizar una operación Guardar como.