OBJECT SET PRINT VARIABLE FRAME

Home

4D v16.3


OBJECT SET PRINT VARIABLE FRAME ( {* ;} object ; variableFrame {; fixedSubform} )

Parameter	Type	Description
*	Operator	If specified, object is an object name (string) If omitted, object is a field or variable
object	Form object	Object name (if * is specified) or Field or variable (if * is omitted)
variableFrame	Boolean	True = Variable frame printing, False = Fixed frame printing
fixedSubform	Longint	Options for printing subforms in fixed size

Description

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 the following objects:

Text or Picture type variables and fields (see Print Variable Frame in the Design Reference manual)
4D Write Pro areas (see Using a 4D Write Pro area in the 4D Write Pro reference manual).
Subforms. Subforms have an additional option for fixed size printing (see Subform Printing in the Design Reference manual); the command can be used to configure this option using the fixedSubform parameter.

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.