Función SETATREF

Redirige los valores actualizados resultantes de acciones en la interfaz de usuario (UI) o Automation a otra celda.

Sintaxis

SETATREF(reference [, set_expression [, ignore_eval ]])

Parameters

Comentarios

Cuando una acción del usuario en la ventana de dibujo, o un método automation, hace que Microsoft Visio actualice una celda que contiene una fórmula SETATREF, el valor se redirige a la celda a la que hace referencia la fórmula SETATREF ( referencia). La fórmula de la celda que contiene la función SETATREF permanece intacta.

Si se omite expresión_conjunto, el valor establecido mediante la interfaz de usuario o automatización se asigna a la celda a la que se hace referencia; si no es así, el contenido de expresión_conjunto se asigna a la celda a la que se hace referencia. Esto permite modificar o transformar el nuevo valor antes de asignarlo a la celda de referencia.

La función SETATREF cuenta con dos funciones relacionadas:

• Función SETATREFEXPR, que puede usar para representar el nuevo valor dentro de set_expression. Por ejemplo, una expresión_conjunto que consista en SETATREFEXPR()-2 in. podrá usarse para restar 2 pulgadas al resultado de SETATREFEXPR.

• La función SETATREFEVAL, que puede usar para indicar que alguna parte de set_expression debe evaluarse y reemplazarse por su resultado.

La función SETATREF está diseñada para su uso en celdas que las acciones del usuario pueden cambiar en la ventana de dibujo. Se admiten las siguientes celdas:

• Sección de transformación de forma: celdas Width, Height, Angle, PinX y PinY

• Sección de transformación de texto: celdas TxtWidth, TxtHeight, TxtAngle, TxtPinX y TxtPinY

• Sección de extremos 1D: celdas BeginX, BeginY, EndX y EndY

• Sección de controles: celdas Controls.X y Controls.Y

• Sección Datos de formas

Dado que SETATREF cambia la ubicación donde cambian los valores de celda, afecta al desencadenamiento de eventos. Si una celda contiene SETATREF, los eventos FormulaChanged y CellChanged se desencadenan para la celda a la que hace referencia SETATREF, no para la que contiene SETATREF. Si una celda que contiene SETATREF también contiene SETATREFEXPR, el evento FormulaChanged también se desencadena para la celda que contiene SETATREF porque se cambia un parámetro de función.

A continuación se describen algunos puntos adicionales que conviene tener en cuenta al respecto de la función SETATREF:

• Las funciones SETATREF pueden encadenar hasta un máximo de 10 referencias a otras funciones SETATREF.

• Las celdas pueden contener otras expresiones además de la función SETATREF, incluidas varias apariciones de SETATREF en una misma celda.

• Si las formas están pegadas, Visio sigue la cadena de referencias de SETATREF dentro de la misma hoja y coloca fórmulas de pegado en la celda referida.

• La automatización reconoce la función SETATREF y sigue la cadena de celdas a las que se hace referencia.

• Al igual que ocurre con GUARD, SETATREF no protege las celdas de los cambios realizados mediante la función SETF en ShapeSheet.

Ejemplo 1

Supongamos que una forma posee una propiedad personalizada llamada Width, y la celda Width de la sección de transformación de forma contiene la siguiente fórmula:

=SETATREF(Prop.Width)

Si un usuario cambiara el ancho de la forma en la interfaz de usuario, el nuevo valor se asigna a la celda Prop.Width, no a la celda Width de la sección ShapeTransform; la fórmula de la celda Width permanece sin cambios. También es posible establecer el ancho de la forma mediante los datos de formas.

Ejemplo 2

Las soluciones de Visio suelen contar con formas relacionadas jerárquicamente, y así se precisa que las formas secundarias se muevan cuando lo hace una principal. A continuación se muestra un ejemplo de cómo se puede administrar esta relación con la función SETATREF en ShapeSheet.

Las siguientes fórmulas se encuentran en la sección de transformación de formas de la forma secundaria. Además, definimos unas celdas de usuario llamadas Usuario.DeltaX y Usuario.DeltaY, que rastrean la cota de desplazamiento de ParentShape. Esto permite a la forma secundaria moverse cuando lo hace la principal, además de preservar la jerarquía si se mueve la secundaria.

PinX =SETATREF(Usuario.DeltaX; SETATREFEVAL(SETATREFEXPR() - ParentShape!PinX)) + ParentShape!PinX

PinY =SETATREF(Usuario.DeltaY; SETATREFEVAL(SETATREFEXPR() - ParentShape!PinY)) + ParentShape!PinY

Cuando la forma secundaria se mueve mediante la interfaz de usuario, los nuevos valores PinX y PinY se establecen como parámetro en la función SETATREFEXPR. La función SETATREF evalúa la fórmula incluida en SETATREFEVAL y reemplaza PinX y PinY por sus resultados y, a continuación, la fórmula resultante se asigna a las celdas de usuario a las que se hace referencia en la función SETATREF: User.DeltaX y User.DeltaY. Por último, los valores devueltos por SETATREF (User.DeltaX o User.DeltaY) se agregan a la ubicación de anclaje de ParentShape para calcular la ubicación de anclaje de la forma secundaria.