y

Determina la coordenada y de un objeto de diseño de formulario especificado en relación con su objeto principal

Sintaxis

Reference_Syntax.y( OBJECT param1 [, STRING param2 [, INTEGER param3 ] ] )

Parámetros

param1

Expresión de sintaxis de referencia completa de uno de los siguientes objetos contenedores del Modelo de objetos de formulario XML: area, contentArea, draw, field, pageArea, subform.

param2 (opcional)

Una cadena que representa el tipo de unidad del valor devuelto. Si se deja en blanco, el tipo de unidad predeterminado es puntos.

param3 (opcional)

Un entero que representa un valor de índice de base 0 que indica el área de contenido en la que desea obtener la coordenada y del objeto. Si se deja en blanco, el valor predeterminado es 0.

Este parámetro le permite calcular la coordenada y de un objeto que se distribuye en varias áreas de contenido, como páginas. Por ejemplo, si desea buscar el posicionamiento absoluto y de un objeto de subformulario que ocupa varias áreas de contenido, utilice este parámetro para enumerar la coordenada y del subformulario en cada una de las áreas de contenido y sumar el total.

Si el objeto sobre el que desea calcular una coordenada y está anidado en varias capas de los objetos principales, deberá tener en cuenta la coordenada y de cada objeto principal cuando calcule la coordenada y real del objeto.

Devuelve

La coordenada y del objeto de diseño de formulario como doble.

Aplicable a

Modelo	Objeto
Modelo de presentación	layoutPseudoModel

Versión

XFA 2,1

Ejemplos

JavaScript

// Returns the y coordinate of a single instance of TextField1, relative to 
// its parent object. 
xfa.layout.y(TextField1,"in"); 
 
// Calculates the y coordinate of Subform1 across two content areas and 
// displays the total in a message box. 
var iY = xfa.layout.y(Subform1,"in",0) + xfa.layout.y(Subform1,"in",1); 
xfa.host.messageBox(iY);

FormCalc

// Returns the y coordinate of a single instance of TextField1, relative to 
// its parent object. 
xfa.layout.y(TextField1,"in") 
 
// Calculates the y coordinate of Subform1 across two content areas and 
// displays the total in a message box. 
var iY = xfa.layout.y(Subform1,"in",0) + xfa.layout.y(Subform1,"in",1) 
xfa.host.messageBox(iY)