PRINT OPTION VALUES

4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next

version 2003


PRINT OPTION VALUES (option; namesArray{; info1Array{; info2Array}})

ParameterTypeDescription
optionLongintOption number
namesArrayText ArrayNames of values
info1ArrayLongint ArrayValues (1) of the option
info2ArrayLongint ArrayValues (2) of the option

Description

In namesArray, the PRINT OPTION VALUES command returns a list of value names available for the print option defined. Optionally, you can retrieve information for each value in info1Array and info2Array.

The option parameter allows you to specify the option to get. You must pass one of the following constants of the "Print options" theme (options able to return lists of value names):

ConstantTypeValue
Paper optionLongint1
Paper source optionLongint5

After command execution, the namesArray array as well as, where applicable, the info1Array and info2Array arrays will be filled in by the command with the names and information of the available values.

If you pass value 1 (paper option) in the option parameter, the command will return the following information:

in namesArray, the names of the available paper formats;

in info1Array, the heights of each paper format;

in info2Array, the widths of each paper format.

Note: In order to obtain this information, the print driver must have access to a valid PPD (PostScript Printer Description) file for the printer.

In order to apply a specific paper format using the SET PRINT OPTION command, you can either pass one of the values of namesArray, the corresponding values of info1Array and info2Array.

If you pass value 5 (paper source option) in the option parameter, the command returns the names of the different trays available in namesArray, and their internal Windows ID numbers in info1Array (info2Array remains empty).

The order of the values in the arrays is defined by the print driver. To indicate a tray using the SET PRINT OPTION command, you must pass the index, as found in the namesArray or info1Array arrays, of the element desired.

Note: This option can only be used under Windows.

For more information on the different print options, refer to the description of the SET PRINT OPTION and GET PRINT OPTION commands.

All the information returned by these commands is supplied by the operating system. Refer to the documentation of your system for more details about specific options.

Note: The PRINT OPTION VALUES command only operates with PostScript printers.

See Also

GET PRINT OPTION, SET PRINT OPTION.

Constants

Print options theme.


4D - Documentation   Français   English   German   4th Dimension 2004, Command Theme List   4th Dimension 2004, Command Alphabetical List   4th Dimension 2004, Constant Theme List   Back   Previous   Next