h

Bestimmt die Höhe eines angegebenen Formularentwurfsobjekts.

Syntax

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

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

Rückgabe

Die Höhe des Formularobjekts im angegebenen Inhaltsbereich.

Gilt für

Modell	Objekt
Layoutmodell	layoutPseudoModel

Version

XFA 2.1

Beispiele

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)