h

Determina a altura de um determinado objeto de design de formulário.

Sintaxe

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

Parâmetros

param1

A expressão da sintaxe de referência totalmente qualificada de um dos seguintes objetos do Modelo de objeto de formulário XML do contêiner: area, contentArea, draw, field, pageArea, subformulário.

param2 (Opcional)

Uma string que representa o tipo de unidade do valor de retorno. Se permanecer em branco, o tipo de unidade padrão será pontos.

param3 (Opcional)

Um número inteiro representando um valor de índice baseado em zero que indica a área de conteúdo na qual você deseja obter a altura do objeto. Se permanecer em branco, o valor padrão será 0.

Este parâmetro permite calcular a altura de um objeto distribuído por várias áreas de conteúdo, como páginas. Por exemplo, para determinar a altura de um objeto de subformulário que abrange várias áreas de conteúdo, você deve usar este parâmetro para enumerar a altura do subformulário em cada uma das áreas de conteúdo e somar os totais.

Retorna

A altura do objeto de design de formulário na área de conteúdo especificada.

Aplica-se a

Modelo	Objeto
Modelo de layout	layoutPseudoModel

Versão

XFA 2.1

Exemplos

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)