y

Determina la coordinata y dell'oggetto struttura del modulo specificato rispetto all'oggetto principale.

Sintassi

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

Parametri

param1

La sintassi di riferimento completa di uno dei seguenti contenitori oggetti del modello di oggetti modulo XML: area, contentArea, draw, field, pageArea, subform.

param2 (facoltativo)

Una stringa che rappresenta il tipo di unità del valore restituito. Se lasciata vuota, il tipo di unità predefinito è punti.

param3 (facoltativo)

Un intero che rappresenta un valore indice basato su zero e indica l'area contenuto all'interno della quale si desidera ottenere la coordinata y dell'oggetto. Se vuoto, il valore predefinito è 0.

Il parametro consente di calcolare la coordinata y di un oggetto distribuito su più aree di contenuto, ad esempio pagine. Ad esempio, se si desidera trovare la posizione y assoluta di un oggetto sottomodulo che si espande su più aree di contenuto, utilizzare questo parametro per calcolare la coordinata y del sottomodulo in ciascuna area di contenuto e aggiungere i totali complessivi.

Se l'oggetto per il quale si desidera calcolare la coordinata y è annidato in più livelli di oggetti principali, è necessario fattorizzare la coordinata y di ciascun elemento principale per ottenere la coordinata y effettiva dell'oggetto.

Valore restituito

La coordinata y dell'oggetto struttura del modulo come duplicato.

Si applica a

Modello	Oggetto
Modello Layout	layoutPseudoModel

Versione

XFA 2.1

Esempi

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)