|
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
,
Feld
,
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.
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)
|
|
|
