4D Doc Center : PV SET PRINT PROPERTY

Home

4D View v14

PV SET PRINT PROPERTY


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 table details the constants which can be used in both the property and value parameters:

Constant	Type	Value	Comment
pv print adjust area	Longint	10	Allows adjusting (or not) of the printable area. Associated values: pv value on: the printable area is adjusted. pv value off: the printable area is not adjusted.
pv print binding	Longint	26	Used to set or get the location of the binding when printing is carried out in double-sided mode (see above). Associated values: the following 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 bottom margin	Longint	3	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.
pv print centered	Longint	9	Allows centering (or not) of the printing on the page. Associated values: pv value on: the printing is centered on the page. pv value off: the printing is not centered on the page.
pv print color	Longint	23	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 dead bottom margin	Longint	18	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 dead left margin	Longint	15	This constant is read-only (PV Get print property command) and returns the size, in pixels, of the left 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 dead right margin	Longint	17	This constant is read-only (PV Get print property command) and returns the size, in pixels, of the right 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 dead top margin	Longint	16	This constant is read-only (PV Get print property command) and returns the size, in pixels, of the top 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 destination	Longint	24	Used to set or get the print destination. Associated values: the following constants of the PV Print values theme: 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 document name	Longint	27	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 double sided	Longint	25	Used to print as single- or double-sided. Associated values: 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 frame each page	Longint	11	Allows printing of a frame (or not) around each printed page. Associated values: pv value on: a frame is printed on each page. pv value off: no frame is printed.
pv print grid	Longint	12	Allows printing (or not) of a grid on the area. Associated values: pv value on: the grid is printed. pv value off: the grid is not printed.
pv print headers	Longint	8	Allows printing (or not) of the row and column headers. Associated values: pv value on: row and column headers are printed. pv value off: row and column headers are not printed.
pv print left margin	Longint	0	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 number copies	Longint	21	Used to set or get the number of copies to be printed. Associated values: number of copies (1 by default).
pv print orientation	Longint	19	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 pages from	Longint	28	Used to set or get the number of the page where you want printing to start. Associated values: page number.
pv print pages to	Longint	29	Used to set or get the number of the last page that you want to be printed. Associated values: page number.
pv print paper height	Longint	14	Returns the paper height. Associated values: height in pixels.
pv print paper source	Longint	22	Used to set or get the paper tray to be used. Associated values: value of the info1Array element that corresponds to the element of the namesArray returned by the 4D PRINT OPTION VALUES command. This array contains the name of the paper tray to be used. Note: This property can only be used under Windows.
pv print paper width	Longint	13	Returns the paper width. Associated values: width in pixels.
pv print repeat first column	Longint	4	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 first row	Longint	6	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 column	Longint	5	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 last row	Longint	7	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 right margin	Longint	2	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 scale	Longint	20	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 top margin	Longint	1	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.

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
Automatic Selection	15
Tray 1	257
Tray 1 (Manual)	258
Tray 2	259
Tray 3	260
Tray 4	261
Envelope Feeder	262

If you want to use “Tray 1 (Manual),” you just need to pass the value of $arrInfo1 that corresponds to this tray:

PV SET PRINT PROPERTY(area;pv print paper source;$arrInfo1{3})