w

Détermine la largeur d’un objet de conception de formulaire donné.

Syntaxe

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

Paramètres

param1

L’expression de syntaxe de référence complète d’un des objets de formulaire suivant : area, contentArea, draw, field, pageArea, subform.

param2 (facultatif)

Chaîne représentant le type d’unité de la valeur renvoyée. Si le paramètre est vide, le type d’unité par défaut est points.

param3 (facultatif)

Entier représentant une valeur d’index de base zéro indiquant la zone de contenu dans laquelle vous souhaitez obtenir la largeur de l’objet. Si aucune valeur n’est définie, la valeur par défaut est 0.

Ce paramètre permet de calculer la largeur d’un objet distribué dans plusieurs zones de contenu, telles que des pages. Par exemple, si vous souhaitez trouver la largeur d’un objet de sous-formulaire qui s’étend sur plusieurs zones de contenu, vous pouvez utiliser ce paramètre pour calculer la largeur du sous-formulaire dans chacune des zones de contenu et additionner les totaux.

Renvoie

Largeur de l’objet de conception de formulaire dans la zone de contenu actuelle.

Application

Version

XFA 2.1

Exemples

JavaScript

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

FormCalc

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