The OBJECT SET PRINT VARIABLE FRAME command modifies the Print Variable Frame property of the object(s) designated by the object and * parameters.
This property is available for Text or Picture type variables and fields, as well as subforms. Subforms have an additional option for fixed size printing. For more information, refer to Printing areas of variable size in the Design Reference manual. If you apply this command to an object that does not support this property, the command does nothing.
Passing the optional * parameter indicates that the object parameter is an object name (string). If you do not pass this parameter, it indicates that the object parameter is a field or variable. In this case, you pass a field or variable reference instead of a string (field or variable object only).
Pass a Boolean in the variableFrame parameter: if you pass True, the object is printed with a variable frame. If you pass False, it is printed with a fixed frame.
The optional fixedSubform parameter lets you set an additional option when you pass False in the variableFrame parameter and the object is a subform (it is ignored in all other cases). In this case, you can define the fixed frame printing mode for the subform. You can pass one of the following constants, found in the "Form Objects (Properties)" theme:
Constant |
Type |
Value |
Comment |
Print Frame fixed with multiple records |
Longint |
2 |
The frame remains the same size, but 4D prints the form several times to include all the records.
|
Print Frame fixed with truncation |
Longint |
1 |
4D prints only the records that fit into the area of the subform. The form is printed only once and those records that are not printed are ignored. |