Functions Reference

Logical functions
F
ILEMAKER FUNCTIONS REFERENCE 227
height - returns a number representing the height (in points) of the specified object.
rotation - returns a number representing the rotation (in degrees) of the specified object.
startPoint,endPoint - returns a pair of numeric values (horizontal vertical), separated by
spaces, that represent the start point or end point of a line object. Other objects return the top-left
point for
startPoint and the bottom-right point for endPoint.
source - returns the source description of the specified object as follows. For:
web viewers - returns current URL.
fields - returns the fully qualified field name (table name::field name).
text objects - returns the text (does not return merge fields).
portals - returns the related table name.
graphics - returns image data such as the image filename.
charts - returns the XML description of a chart object.
For all other objects, returns an empty string.
content - returns the content of the specified object as follows. For:
web viewers - returns the current content (such as HTML code).
fields - returns the field data formatted using the specified object's properties.
text objects - returns the text (including text from merge fields).
graphics - returns image data such as the name of a file in a container field if the image is stored
(in the field or externally), or the reference to the file if the image is unstored.
charts - returns the bitmap representation of a chart object.
For all other objects, returns an empty string.
enclosingObject - returns objectName of the enclosing layout object. Otherwise, returns an
empty string. Only groups, tab panels, slide panels, popover buttons, popovers, and portals can
contain other objects.
containedObjects - returns a list of named objects contained within objectName. Only groups,
tab panels, slide panels, popover buttons, popovers, and portals can contain other objects.
isobjecthidden - returns 1 (True) if objectName is hidden for the current record. Otherwise,
returns 0 (False). Returns 1 for objects other than popovers that are to the right of the layout
boundary.
Notes
• If objects are set to auto-resize, attributes returned are based on the resized bounds of the
object in its current state.
• If objects are located above the status toolbar, negative coordinate values are returned.
• When repetitionNumber or portalRowNumber is 0, the function behaves as if the
parameter was not specified. For
portalRowNumber, the function returns data from the
first portal row. For
repetitionNumber, the function acts on the first repetition (for
returning
content or source) or acts on the entire field as a whole (for returning bounds).
Both parameters are necessary because you must be able to reference a particular field
repetition within a particular portal row.