4D v14.3
OBJECT GET BEST SIZE
- 4D Language Reference
-
- Objects (Forms)
-
- Object Properties
- GET STYLE SHEET INFONew
- LIST OF STYLE SHEETSNew
- OBJECT DUPLICATE
- OBJECT Get actionNew
- OBJECT Get auto spellcheck
- OBJECT GET BEST SIZE
- OBJECT Get border styleNew
- OBJECT Get context menuNew
- OBJECT GET COORDINATES
- OBJECT Get data sourceNew
- OBJECT GET DRAG AND DROP OPTIONS
- OBJECT Get enabled
- OBJECT Get enterable
- OBJECT GET EVENTSNew
- OBJECT Get filter
- OBJECT Get focus rectangle invisible
- OBJECT Get font
- OBJECT Get font size
- OBJECT Get font style
- OBJECT Get format
- OBJECT Get help tip
- OBJECT Get horizontal alignment
- OBJECT Get indicator typeNew
- OBJECT Get keyboard layout
- OBJECT Get list nameUpd
- OBJECT Get list referenceNew
- OBJECT GET MAXIMUM VALUENew
- OBJECT GET MINIMUM VALUENew
- OBJECT Get multilineNew
- OBJECT Get placeholderNew
- OBJECT GET PRINT VARIABLE FRAMENew
- OBJECT GET RESIZING OPTIONS
- OBJECT GET RGB COLORS
- OBJECT GET SCROLL POSITION
- OBJECT GET SCROLLBARUpd
- OBJECT GET SHORTCUT
- OBJECT Get style sheetNew
- OBJECT GET SUBFORM
- OBJECT GET SUBFORM CONTAINER SIZE
- OBJECT Get text orientationNew
- OBJECT Get three states checkboxNew
- OBJECT Get title
- OBJECT Get typeNew
- OBJECT Get vertical alignment
- OBJECT Get visible
- OBJECT Is styled textNew
- OBJECT MOVE
- OBJECT SET ACTIONNew
- OBJECT SET AUTO SPELLCHECK
- OBJECT SET BORDER STYLENew
- OBJECT SET COLOR
- OBJECT SET CONTEXT MENUNew
- OBJECT SET COORDINATESNew
- OBJECT SET DATA SOURCENew
- OBJECT SET DRAG AND DROP OPTIONS
- OBJECT SET ENABLED
- OBJECT SET ENTERABLE
- OBJECT SET EVENTSNew
- OBJECT SET FILTER
- OBJECT SET FOCUS RECTANGLE INVISIBLE
- OBJECT SET FONT SIZE
- OBJECT SET FONT STYLE
- OBJECT SET FONTUpd
- OBJECT SET FORMAT
- OBJECT SET HELP TIP
- OBJECT SET HORIZONTAL ALIGNMENT
- OBJECT SET INDICATOR TYPENew
- OBJECT SET KEYBOARD LAYOUT
- OBJECT SET LIST BY NAMEUpd
- OBJECT SET LIST BY REFERENCENew
- OBJECT SET MAXIMUM VALUENew
- OBJECT SET MINIMUM VALUENew
- OBJECT SET MULTILINENew
- OBJECT SET PLACEHOLDERNew
- OBJECT SET PRINT VARIABLE FRAMENew
- OBJECT SET RESIZING OPTIONS
- OBJECT SET RGB COLORSUpd
- OBJECT SET SCROLL POSITION
- OBJECT SET SCROLLBARUpd
- OBJECT SET SHORTCUT
- OBJECT SET STYLE SHEETNew
- OBJECT SET SUBFORM
- OBJECT SET TEXT ORIENTATIONNew
- OBJECT SET THREE STATES CHECKBOXNew
- OBJECT SET TITLE
- OBJECT SET VERTICAL ALIGNMENT
- OBJECT SET VISIBLE
- DISABLE BUTTON
- ENABLE BUTTON
OBJECT GET BEST SIZE
| OBJECT GET BEST SIZE ( {* ;} object ; bestWidth ; bestHeight {; maxWidth} ) | ||||||||
| Parameter | Type | Description | ||||||
| * | Operator |
|
If specified = object is an object name (String) If omitted = object is a variable | |||||
| object | Form object |
|
Object name (if * is specified) or Field or variable (if * is omitted) | |||||
| bestWidth | Longint |
|
Optimum object width | |||||
| bestHeight | Longint |
|
Optimum object height | |||||
| maxWidth | Longint |
|
Maximum object width | |||||
The OBJECT GET BEST 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 OBJECT MOVE 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. Usually 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. Note that in the case of 3D buttons, the command works even when button contains only an icon. 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, OBJECT GET BEST 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 OBJECT GET BEST SIZE command returns the current object size (defined in the form editor and possibly using the OBJECT MOVE command).
Refer to the example in the SET PRINT MARKER command.
Product: 4D
Theme: Objects (Forms)
Number:
717
Created: 4D 2003
Renamed: 4D v12
4D Language Reference ( 4D v12.4)
4D Language Reference ( 4D v14 R3)
4D Language Reference ( 4D v14 R2)
4D Language Reference ( 4D v13.5)
4D Language Reference ( 4D v14.3)
4D Language Reference ( 4D v14 R4)
Inherited from : BEST OBJECT SIZE ( 4D v11 SQL Release 6)
