y

Determina a coordenada Y de um determinado objeto de design de formulário em relação ao objeto pai.

Sintaxe

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

Parâmetros

param1

A expressão da sintaxe de referência totalmente qualificada de um dos seguintes objetos do Modelo de objeto de formulário XML do contêiner: area, contentArea, draw, field, pageArea, subformulário.

param2 (Opcional)

Uma string que representa o tipo de unidade do valor de retorno. Se permanecer em branco, o tipo de unidade padrão será pontos.

param3 (Opcional)

Um número inteiro representando um valor de índice baseado em zero que indica a área de conteúdo na qual você deseja obter a coordenada Y do objeto. Se permanecer em branco, o valor padrão será 0.

Este parâmetro permite calcular a coordenada Y de um objeto distribuído por várias áreas de conteúdo, como páginas. Por exemplo, para determinar o posicionamento de Y absoluto de um objeto de subformulário que abrange várias áreas de conteúdo, você deve usar este parâmetro para enumerar a coordenada Y do subformulário em cada uma das áreas de conteúdo e somar os totais.

Se o objeto para o qual você deseja calcular uma coordenada Y é aninhado dentro de várias camadas de objetos pais, você deve fatorar a coordenada Y de cada objeto pai ao calcular a coordenada Y real do objeto.

Retorna

A coordenada y do objeto de design de formulário como um duplo.

Aplica-se a

Modelo	Objeto
Modelo de layout	layoutPseudoModel

Versão

XFA 2.1

Exemplos

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)