Command PV SET PRINT PROPERTY

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

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 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:

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)

PV Get print property.

PV Print properties and PV Print values theme.