y

Hiermee wordt de y-coördinaat bepaald van een formulierontwerpobject ten opzichte van het bovenliggende object.

Syntaxis

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

Parameters

param1

De volledig gekwalificeerde verwijzingssyntaxisexpressie van een van de volgende containerobjecten van het XML-formulierobjectmodel: area, contentArea, draw, field, pageArea, subform.

param2 (optioneel)

Een tekenreeks die staat voor het type eenheid van de retourwaarde. Als deze parameter niet wordt opgegeven, is het standaardeenheidtype 'punten'.

param3 (optioneel)

Een geheel getal dat staat voor een op nul gebaseerde indexwaarde die het inhoudsgebied aangeeft waarvan u de y-coördinaat van het object wilt bepalen. Als deze parameter niet wordt opgegeven, is de standaardwaarde 0.

Met deze parameter kunt u de y-coördinaat berekenen van een object dat is verdeeld over meerdere inhoudsgebieden, zoals pagina's. Als u bijvoorbeeld de absolute y-positie wilt weten van een subformulierobject dat meerdere inhoudsgebieden beslaat, kunt u met deze parameter de y-coördinaat van het formulier in elk van de inhoudsgebieden opsommen en de totalen bij elkaar optellen.

Als het object waarvoor u een y-coördinaat wilt berekenen, in verschillende lagen bovenliggende objecten is genest, moet u rekening houden met de y-coördinaat van elk bovenliggend object wanneer u de eigenlijke y-coördinaat van het object berekent.

Geeft als resultaat

De y-coördinaat van het formulierontwerpobject als een dubbele waarde.

Van toepassing op

Model	Object
Indelingsmodel	layoutPseudoModel

Versie

XFA 2.1

Voorbeelden

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)