Determines the x coordinate of
a given form design object relative to its parent object.
SyntaxReference_Syntax.x( OBJECT param1 [, STRING param2 [, INTEGER param3 ] ] )
Parameters
param1
|
The fully qualified reference syntax expression
of one of the following container XML Form Object Model objects: area, contentArea, draw, field, pageArea, subform.
|
param2 (Optional)
|
A string representing the unit type of the
return value. If left blank, the default unit type is points.
|
param3 (Optional)
|
An integer representing a zero-based index
value indicating the content area in which you want to obtain the
object’s x coordinate. If left blank, the default value is 0.
This
parameter allows you to calculate the x coordinate of an object
that is distributed across multiple content areas, such as pages.
For example, if you want to find the absolute x positioning of a
subform object that spans multiple content areas, you would use
this parameter to enumerate the x coordinate of the subform in each
of the content areas and add the totals together.
If the
object for which you want to calculate an x coordinate is nested
within several layers of parent objects, you must factor in the
x coordinate of each parent object when computing the actual x coordinate
of the object.
|
ReturnsThe
x coordinate of the form design object relative to its parent object.
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)
|
|
|