x

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

Sintaxe

Reference_Syntax.x( 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 X do objeto. Se permanecer em branco, o valor padrão será 0.

Este parâmetro permite calcular a coordenada X de um objeto distribuído por várias áreas de conteúdo, como páginas. Por exemplo, para determinar o posicionamento de X 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 X 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 X é aninhado dentro de várias camadas de objetos pais, você deve fatorar a coordenada X de cada objeto pai ao calcular a coordenada X real do objeto.

Retorna

A coordenada X de um objeto de design de formulário em relação ao objeto pai.

Aplica-se a

Modelo	Objeto
Modelo de layout	layoutPseudoModel

Versão

XFA 2.1

Exemplos

JavaScript

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

FormCalc

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