PV SET PRINT PROPERTY
version 2004.1 (Modified)
PV SET PRINT PROPERTY (area; property; value{; value2})
| Parameter | Type | Description | |
| area | Longint |  | 4D View area |
| property | Longint | | Property number |
| value | Longint | | Value of the property |
| value2 | String | | Additional property value |
Description
The PV SET PRINT PROPERTY command sets the value and, optionally, the value2 of the property for the specified 4D View area.
Use the PV Print properties constants to define the property parameter. The following list details the constants which can be used in both the property and value parameters:
pv print left margin
The left margin is the area between the left side of the paper (including the left dead margin) and the print area. Associated values: margin in pixels.
pv print top margin
The top margin is the area between the top side of the paper (including the top dead margin) and the print area. Associated values: margin in pixels.
pv print right margin
The right margin is the area between the right side of the paper (including the right dead margin) and the print area. Associated values: margin in pixels.
pv print bottom margin
The bottom margin is the area between the bottom side of the paper (including the bottom dead margin) and the footer. Associated values: margin in pixels.
Note: See below for more information regarding dead margins.
pv print repeat first column
Indicates the number of the first column of the range to be printed on each page. This constant must be used in combination with the pv print repeat last column constant. Associated values: column number.
pv print repeat last column
Indicates the number of the last column of the range to be printed on each page. This constant must be used in combination with the pv print repeat first column constant. Associated values: column number.
pv print repeat first row
Indicates the number of the first row of the range to be printed on each page. This constant must be used in combination with the pv print repeat last row constant. Associated values: row number.
pv print repeat last row
Indicates the number of the last row of the range to be printed on each page. This constant must be used in combination with the pv print repeat first row constant. Associated values: row number.
pv print headers
Allows printing (or not) of the row and column headers. Associated values: pv value on or pv value off
• pv value on: row and column headers are printed.
• pv value off: row and column headers are not printed.
pv print centered
Allows centering (or not) of the printing on the page. Associated values: pv value on or pv value off
• pv value on: the printing is centered on the page.
• pv value off: the printing is not centered on the page.
pv print adjust area
Allows adjusting (or not) of the printable area. Associated values: pv value on or pv value off
• pv value on: the printable area is adjusted.
• pv value off: the printable area is not adjusted.
pv print frame each page
Allows printing of a frame (or not) around each printed page. Associated values: pv value on or pv value off
• pv value on: a frame is printed on each page.
• pv value off: no frame is printed.
pv print grid
Allows printing (or not) of a grid on the area. Associated values: pv value on or pv value off
• pv value on: the grid is printed.
• pv value off: the grid is not printed.
pv print orientation
Allows setting or reading paper orientation at the time of printing. Associated values: PV Print values theme constants.
• pv portrait orientation: the paper is oriented in portrait mode.
• pv landscape orientation: the paper is oriented in landscape mode.
pv print paper width
Returns the paper width. Associated values: width in pixels.
pv print paper height
Returns the paper height. Associated values: height in pixels.
pv print dead left margin
This constant is read-only (PV Get print property command) and returns the size, in pixels, of the left dead margin.
pv print dead top margin
This constant is read-only (PV Get print property command) and returns the size, in pixels, of the top dead margin.
pv print dead right margin
This constant is read-only (PV Get print property command) and returns the size, in pixels, of the right dead margin.
pv print dead bottom margin
This constant is read-only (PV Get print property command) and returns the size, in pixels, of the bottom dead margin.
Note: The dead margin is the non-printable area located at the edges of the paper. This area is set by the print drive.
pv print scale
Used to set or get the current print scale. Keep in mind, however, that some printers do not allow you to modify the scale. If you pass an invalid value, the property is reset to 100% at the time of printing. Associated values: print scale.
pv print number copies
Used to set or get the number of copies to be printed. Associated values: number of copies (1 by default).
pv print paper source
Used to set or get the paper tray to be used. Associated values: number corresponding to the index, in the array of trays returned by the 4D PRINT OPTION VALUES command, of the paper tray to be used.
Note: This property can only be used under Windows.
pv print color
Used to set or get the mode for handling color. This property is only useful with color printers. Associated values: constants of the "PV Print values" theme:
• pv black and white: printing in black and white (monochrome).
• pv color: printing in color.
Note: This property can only be used under Windows.
pv print destination
Used to set or get the print destination. Associated values: constants of the PV Print values theme beginning with "pv destination":
• pv destination printer: the print job is sent to the printer.
• pv destination file (Windows only): the print job is sent to a file. When this constant is used, value2 contains the pathname for the resulting document. If you pass an empty string in value2 or omit this parameter, a save file dialog box will appear at the time of printing.
• pv destination PDF file (Mac OS only): the print job is sent to a PDF file. When this constant is used, value2 contains the pathname for the resulting PDF document. If you pass an empty string in value2 or omit this parameter, a save file dialog box will appear at the time of printing.
• pv destination EPS file (Mac OS only): the print job is sent to an EPS file. When this constant is used, value2 contains the pathname for the resulting EPS document. If you pass an empty string in value2 or omit this parameter, a save file dialog box will appear at the time of printing.
pv print double sided
Used to print as single- or double-sided. Associated values: pv value on or pv value off constants.
• pv value on: double-sided printing.
• pv value off: single-sided printing (default value).
Note: This property can only be used under Windows.
pv print binding
Used to set or get the location of the binding when printing is carried out in double-sided mode (see above). Associated values: constants of the "PV Print values" theme:
• pv left binding: left binding (default value).
• pv top binding: top binding.
Note: This property can only be used under Windows.
pv print document name
Used to set or get the name of the print document that must appear in the list of spooler documents. When this constant is used, value2 contains the name of the print document. Pass 0 in value.
To use or restore standard operation (use of the name "4D View"), pass an empty string in value2.
pv print pages from
Used to set or get the number of the page where you want printing to start.
Associated values: page number.
pv print pages to
Used to set or get the number of the last page that you want to be printed.
Associated values: page number.
Example
Example for choosing the paper tray (source) under Windows:
ARRAY TEXT($arrNames;0)
ARRAY LONGINT($arrInfo1;0)
`Retrieval of the list of available trays
PRINT OPTION VALUES(Paper source;$arrNames;$arrInfo1)
Here is what you could retrieve, for example in the $arrNames and $arrInfo1 arrays:
| $arrNames | $arrInfo1 | Index |
| Automatic Selection | 15 | 1 |
| Tray 1 | 257 | 2 |
| Tray 1 (Manual) | 258 | 3 |
| Tray 2 | 259 | 4 |
| Tray 3 | 260 | 5 |
| Tray 4 | 261 | 6 |
| Envelope Feeder | 262 | 7 |
If you want to use "Tray 1 (Manual)," you just need to pass the index corresponding to this tray:
PV SET PRINT PROPERTY(area; pv print paper source;3)
See Also
Constants
PV Print properties and PV Print values theme.