h

Hiermee wordt de hoogte bepaald van een formulierontwerpobject.

Syntaxis

Reference_Syntax.h( 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 objecthoogte wilt bepalen. Als deze parameter niet wordt opgegeven, is de standaardwaarde 0.

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

Geeft als resultaat

De hoogte van het formulierontwerpobject in het opgegeven inhoudsgebied.

Van toepassing op

Versie

XFA 2.1

Voorbeelden

JavaScript

// Returns the height of a single instance of TextField1 
xfa.layout.h(TextField1,"in"); 
 
// Calculates the height of Subform1 across two content areas and displays 
// the total in a message box. 
var iHeight = xfa.layout.h(Subform1,"in",0) + xfa.layout.h(Subform1,"in",1); 
xfa.host.messageBox(iHeight);

FormCalc

// Returns the height of a single instance of TextField1 
xfa.layout.h(TextField1,"in") 
 
// Calculates the height of Subform1 across two content areas and displays 
// the total in a message box. 
var iHeight = xfa.layout.h(Subform1,"in",0) + xfa.layout.h(Subform1,"in",1) 
xfa.host.messageBox(iHeight)