y

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

Syntax

Reference_Syntax.y( 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 y-Koordinate des Objekts abrufen möchten. Wenn nichts eingegeben wird, ist der Standardwert 0.

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

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

Rückgabe

Die Y-Koordinate des Formularentwurfsobjekts als Double.

Gilt für

Version

XFA 2.1

Beispiele

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)