GetModuleRefBox
(Engine-Level Function)
Description: | Returns the outer reference box for any selectable (GUI) graphics in a module. |
Returns: | Numeric |
Usage: | Script or steady state. |
Function Groups: | Compilation and On-Line Modifications, Advanced Module, Graphics |
Related to: | GetXformRefBox | SetModuleRefBox |
Format: | GetModuleRefBox(Module, Option) |
Parameters: |
Module | ||||||||||||||
Required. Any expression for the code value of the module. | ||||||||||||||
Option | ||||||||||||||
Required. Any expression that defines the return value as indicated by the following:
|
Comments: |
A module's reference box defines an area that will exactly enclose all layered (GUI) graphics in the module regardless of state before any rotations and trajectories have been applied. A module reference box, or MRB as it is sometimes called, is not a clipping region and objects can and often will extend outside of their MRB as a result of applied rotations or trajectories. When a module is transformed, the transform is based on the size of the module as determined by its reference box. The module's reference box will always exactly fill the reference box of the transform. In the case of graphics that have had a rotation or trajectory applied to them, the graphics will be transformed correctly, but the MRB may no longer contain the objects in their modified positions. If a SetModuleRefBox has been done within the module in question, or its module reference box has been defined by following the module name with the four boundaries enclosed in parentheses, the return value will be based on these explicitly defined boundaries. Otherwise the return value will define the minimum reference box that will exactly enclose all (GUI) graphics in the module. This does not include any child graphics (i.e. graphics created by child modules of Module). |
Example:
If ! Valid(rightSide); [ rightSide = GetModuleRefBox(Self(), 2); ]
Variable rightSide will contain the X-coordinate for the graphic object drawn by this module that is the furthest right in the window.