Referencia de las funciones de dibujo (iLogic)

Utilice las funciones de dibujo para personalizar la forma en que los cambios en el modelo se reflejarán en las hojas de dibujo.

Las funciones de dibujo pueden facilitar la actualización eficiente del modelo y se pueden incluir en las reglas activadas por el evento Cambio de vista de dibujo de iLogic.

Para acceder a las funciones de dibujo, expanda el nodo Dibujo en la ficha Sistema del área Fragmentos del cuadro de diálogo Editar regla de iLogic

ThisDrawing

Accede al dibujo actual de una regla.

ActiveSheet

Accede a la hoja activa de un dibujo. Esta función es un alias de ThisDrawing.ActiveSheet. La mayoría de las operaciones de dibujo se realizan en la hoja activa ya que puede que las otras hojas no estén actualizadas.

ThisDrawing.Sheet

Accede a un hoja del dibujo.

Sintaxis

ThisDrawing.Sheet(“sheetname”)

ResourceFileName

Puede asignar una cadena de nombre de archivo a esta propiedad para especificar el nombre de otro dibujo del que desea extraer el cajetín y las definiciones de marco. Cuando se utilizan las funciones de hoja TitleBlock o Border, iLogic busca en este dibujo recursos que no se encuentren en el dibujo actual. Utilice un nombre de ruta relativa para este nombre de archivo. iLogic busca este archivo en la carpeta del dibujo actual y en la del espacio de trabajo del proyecto. Puede especificar subcarpetas relativas a cualquiera de estas ubicaciones.

Ejemplo

ThisDrawing.ResourceFileName = “DrawingResources1.idw”

KeepExtraResources

Defina esta propiedad como False si las copias de los recursos del archivo externo de recursos no se mantienen en el dibujo actual.

Si define esta propiedad como False, un recurso se suprime cuando es reemplazado por otro. La supresión solo ocurre si ResourceFileName no está en blanco. Se da por hecho que todos los recursos necesarios se encuentran en el archivo de recursos externos.

Ejemplo

ThisDrawing.KeepExtraResources = False

Funciones de hoja

Las funciones de hoja para dibujos se suelen utilizar en la hoja activa. Para restringir una regla de modo que sólo se ejecute en una hoja determinada, puede añadir código en la parte superior de una regla. Por ejemplo:

If (ActiveSheet.Name <> "Sheet:2") Then Return

ChangeSize (con valor de cadena de texto)

Cambia el tamaño de la hoja utilizando una cadena de texto como valor del nuevo tamaño.

Sintaxis

Sheet.ChangeSize (“value”,<MoveBorderItems = True>)

valor

El valor del nuevo tamaño.

MoveBorderItems

Este parámetro es opcional. Si MoveBorderItems se establece en False, las listas de tablas y piezas que se encuentren actualmente en el marco o en la arista de la hoja no se desplazarán al nuevo marco.

Ejemplos

ActiveSheet.ChangeSize (“A”)
ActiveSheet.ChangeSize (“B1”, MoveBorderItems := False)

ChangeSize (con valores personalizados)

Cambia el tamaño de hoja, estableciendo una altura y anchura personalizadas, de las unidades del documento.

Sintaxis

Sheet.ChangeSize (customHeight, customWidth, <MoveBorderItems = True>)

height

La altura en unidades del documento.

width

La anchura en unidades del documento.

MoveBorderItems

Este parámetro es opcional. Si MoveBorderItems se establece en False, las listas de tablas y piezas que se encuentren actualmente en el marco o en la arista de la hoja no se desplazarán al nuevo marco.

Ejemplos

ActiveSheet.ChangeSize (7.2, 4)
ActiveSheet.ChangeSize ( 7.2, 4, MoveBorderItems = False)

Sheet.Border

Cambiar el marco actual de la hoja especificando un nombre diferente. El nombre debe encontrarse en los recursos para dibujos del dibujo actual o en el dibujo ResourceFileName si se ha especificado.

Ejemplos

ActiveSheet.Border = “OtherBorder”
currentName = ActiveSheet.Border

Sheet.TitleBlock

Cambia el cajetín actual de la hoja especificando un nombre diferente. El nombre debe encontrarse en los recursos para dibujos del dibujo actual o en el dibujo ResourceFileName si se ha especificado.

Ejemplos

ActiveSheet.TitleBlock = “ANSI - A”
currentName = ActiveSheet.TitleBlock

Ejemplo con un archivo de origen externo:

ThisDrawing.ResourceFileName = “DrawingResources1.idw”
ActiveSheet.TitleBlock = “Custom - A”

ActiveSheet.Name

Obtiene el nombre de la hoja.

ActiveSheet.Size

Obtiene el tamaño de la hoja en forma de cadena de texto, como "A" o “ B0 ”.

ActiveSheet.Height

Define la altura de la hoja en las unidades del documento.

ActiveSheet.Width

Obtiene la anchura de la hoja en las unidades del documento.

ActiveSheet.View(“viewName”)

Obtiene acceso a una vista del plano.

Funciones de vista

Las funciones de vista para dibujos se suelen utilizar en la hoja activa (recomendado).

View.Name

Obtiene el nombre de la vista.

View.Height

Obtiene la altura de la vista en las unidades del documento de dibujo.

View.Width

Obtiene la anchura de la vista en las unidades del documento de dibujo.

View.Scale

Obtiene o define la escala de la vista como un número.

View.ScaleString

Obtiene o define la escala de la vista en forma de cadena de texto, como “1:2” o “4.1”.

View.SetCenter(centerX,centerY)

Establece el punto central de la vista (desplaza la vista). Las coordenadas se especifican en unidades de documento de dibujo.

View.SetSpacingToCorner(distanceX, distanceY, corner)

Define la posición de la vista (desplaza la vista) especificando la distancia entre una vista de vértice y el vértice de la hoja más cercano. La variable corner puede tener uno de los siguientes valores:

SheetCorner.BottomLeft
SheetCorner.BottomRight
SheetCorner.TopLeft
SheetCorner.TopRight

Las coordenadas se especifican en las unidades del dibujo. iLogic busca el vértice más cercano a un vértice de la hoja.

View.SpacingBetween(“otherViewName”)

Define la posición de la vista (desplaza la vista) especificando el espacio entre esta vista y otra. El nombre de la otra vista suele ser una vista adyacente de la hoja. Se especifica la distancia entre las aristas de vista, en la dirección X o Y. Especifique un valor positivo para colocar esta vista a la derecha o por encima de la otra vista. Especifique un valor negativo para colocar esta vista a la izquierda o por debajo de la otra vista. Por ejemplo:

ActiveSheet.View("VIEW2").SpacingBetween("VIEW1") = 30 mm  '

VIEW2 se encuentra a la derecha de VIEW1.

ActiveSheet.View("VIEW3").SpacingBetween("VIEW1") = -40 mm  '

VIEW3 está por debajo de VIEW1.

View.Balloons

Accede a las referencias numéricas de la vista.

Funciones de referencia numérica

Las funciones de referencia numérica para dibujos están vinculadas a una vista concreta.

Balloons.Reattach

En las vistas de los documentos de ensamblaje, esta función busca referencias numéricas sin asociar y las enlaza a un componente, siempre que sea posible. La primera opción es un componente de extremo. Si no se encuentra ninguno, se utiliza el componente válido sin referencia numérica más próximo. Si la referencia numérica no se puede asociar en el momento, se desplaza a una capa oculta. La capa oculta es una capa creada (si es necesario) con este fin.

Nota: Esta función requiere que la opción Conservar anotaciones huérfanas esté activada para el dibujo (en Herramientas Opciones Parámetros del documento). Si esta opción no está activada, la función la activa automáticamente.

Balloons.AttachToComponent(“componentName”)

Especifica un componente que requiere una referencia numérica. componentName especifica una incidencia de componente, como "Pin: 1". Cuando se utiliza esta función, las referencias numéricas sólo se vuelven a asociar a los componentes que se especifiquen. Si no se utiliza esta función, las referencias numéricas se vuelven a asociar a cualquier componente disponible (a menos que la función DoNotAttachToComponent lo impida).

Balloons.DoNotAttachToComponent(“componentName”)

Especifica un componente que no requiera una referencia numérica. componentName especifica una incidencia de componente, como "Pin: 1".