Détermine la coordonnée x d’un objet de conception de formulaire donné par rapport à son objet parent.
Syntaxe
Reference_Syntax.x( 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 coordonnée x de l’objet. Si aucune valeur n’est définie, la valeur par défaut est
0
.
Ce paramètre permet de calculer la coordonnée x d’un objet distribué dans plusieurs zones de contenu, telles que des pages. Par exemple, si vous souhaitez trouver la coordonnée x absolue d’un objet de sous-formulaire qui s’étend sur plusieurs zones de contenu, vous pouvez utiliser ce paramètre pour calculer la coordonnée x absolue du sous-formulaire dans chacune des zones de contenu et additionner les totaux.
Si l’objet pour lequel vous souhaitez calculer une coordonnée x est imbriqué dans plusieurs couches d’objets parents, vous devez prendre en compte la coordonnée x de chaque objet parent lors du calcul de la coordonnée x réelle de l’objet.
|
Renvoie
La coordonnée x de l’objet de conception de formulaire par rapport à son objet parent.
JavaScript
// Returns the x coordinate of a single instance of TextField1, relative to
// its parent object.
xfa.layout.x(TextField1,"in");
// Calculates the x coordinate of Subform1 across two content areas and
// displays the total in a message box.
var iX = xfa.layout.x(Subform1,"in",0) + xfa.layout.x(Subform1,"in",1);
xfa.host.messageBox(iX);
FormCalc
// Returns the x coordinate of a single instance of TextField1, relative to
// its parent object.
xfa.layout.x(TextField1,"in")
// Calculates the x coordinate of Subform1 across two content areas and
// displays the total in a message box.
var iX = xfa.layout.x(Subform1,"in",0) + xfa.layout.x(Subform1,"in",1)
xfa.host.messageBox(iX)
|
|
|