Bestimmt die Y-Koordinate eines angegebenen Formularentwurfsobjekts relativ zum übergeordneten Objekt.
SyntaxReference_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ückgabeDie Y-Koordinate des Formularentwurfsobjekts als Double.
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)
|
|
|