x

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

Sintassi

Reference_Syntax.x( 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 x dell'oggetto. Se vuoto, il valore predefinito è 0.

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

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

Valore restituito

La coordinata x dell'oggetto struttura del modulo specificata rispetto all'oggetto principale.

Si applica a

Versione

XFA 2.1

Esempi

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)