x

Bestimmt die X-Koordinate eines angegebenen Formularentwurfsobjekts relativ zum übergeordneten Objekt.

Syntax

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

Parameter

param1

Der vollständig qualifizierte Referenzsyntaxausdruck eines der folgenden XML-Formularobjektmodell-Containerobjekte: area, contentArea, draw, field, pageArea, subform.

param2 (Optional)

Eine Zeichenfolge, die den Einheitentyp des Rückgabewerts darstellt. Wenn nichts eingegeben wird, besteht der Standardeinheitentyp aus Punkten.

param3 (Optional)

Eine Ganzzahl, die den 0-basierten Indexwert des Inhaltsbereichs darstellt, aus dem Sie die x-Koordinate des Objekts abrufen möchten. Wenn nichts eingegeben wird, ist der Standardwert 0.

Mit diesem Parameter können Sie die X-Koordinate eines Objekts berechnen, das über mehrere Inhaltsbereiche (z. B. mehrere Seiten) verteilt ist. Wenn Sie die absolute Position eines Teilformularobjekts auf der X-Koordinate ermitteln möchten, das sich über mehrere Inhaltsbereiche erstreckt, können Sie mit diesem Parameter die X-Koordinate des Teilformulars in den einzelnen Inhaltsbereichen aufzählen und die einzelnen Summen addieren.

Ist das Objekt, für das Sie eine X-Koordinate berechnen möchten, in mehreren Ebenen von übergeordneten Objekten verschachtelt, müssen Sie bei der Berechnung der tatsächlichen X-Koordinate des Objekts die X-Koordinaten der jeweiligen übergeordneten Objekte berücksichtigen.

Rückgabe

X-Koordinate des Formularentwurfsobjekts relativ zum übergeordneten Objekt

Gilt für

Modell	Objekt
Layoutmodell	layoutPseudoModel

Version

XFA 2.1

Beispiele

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)