BEST OBJECT SIZE

4D - Documentation   Français   English   German   Spanish   4D v11 SQL, Command Theme List   4D v11 SQL, Command Alphabetical List   4D v11 SQL, Constant Theme List   Back   Previous   Next

version 2003


BEST OBJECT SIZE ({*; }object; bestWidth; bestHeight{; maxWidth})

ParameterTypeDescription
*If specified = object is an object name (String)
If omitted = object is a variable
objectObjectObject name (if * is specified) or
Field or variable (if * is omitted)
bestWidthLongintOptimum object width
bestHeightLongintOptimum object height
maxWidthLongintMaximum object width

Description

The BEST OBJECT SIZE command returns the bestWidth and bestHeight parameters, the "optimal" width and height of the form object designated by the * and object parameters. These values are expressed in pixels. This command is particularly useful for displaying or printing complex reports, associated with the MOVE OBJECT command.

If you pass the optional * parameter, this indicates that the object parameter is an object name (a character string). If you do not pass the * parameter, this indicates that object is a field or a variable. In this case, do not pass a string but rather a field or variable reference (object type only).

The optimal values returned indicate the minimum size of the object so that its current contents are entirely included within the limits. Of course, these values are only meaningful for objects containing text. This calculation takes the font, font size, font style and object contents into account. It also takes hyphenation and carriage returns into consideration. If the object specified is empty, the bestWidth returned is 0.

The size returned does not take into account any graphic frame applied around the object, nor any scrollbars. To obtain the real size of an object on screen, it is necessary to add the width of these elements.

The optional maxWidth parameter enables you to attribute a maximum width to the object. If the optimal width of the object is greater than this value, BEST OBJECT SIZE returns maxWidth in the bestWidth parameter and increases the optimal height as a consequence.

The following objects are handled by this command:

Static text areas

Text inserted in the form of references

Fields and variables of the following types: Alpha, Text, Real, Integer, Long Integer, Date, Time, Boolean (check boxes and radio buttons)

Buttons.

For all other form object types (group areas, tabs, rectangles, straight lines, circles/ovals, external areas, etc.), the BEST OBJECT SIZE command returns the current object size (defined in the form editor and possibly using the MOVE OBJECT command).

Example

Refer to the example in the SET PRINT MARKER command.

See Also

MOVE OBJECT.


4D - Documentation   Français   English   German   Spanish   4D v11 SQL, Command Theme List   4D v11 SQL, Command Alphabetical List   4D v11 SQL, Constant Theme List   Back   Previous   Next