IN_SetPrintOptions

All Editions image\bltlrgsq_shg.gif Related Functions  image\bltlrgsq_shg.gif Example

The IN_SetPrintOptions function sets the default values for print options. The user can change these options in the Print dialog box, or you can specify new options when you use the IN_PrintDocumentWindow function.

Syntax

int IN_SetPrintOptions( rasterize, banner, center, dither, bilevel, scale, orientation, bWriteToINI )

Parameters

Values

Meaning

USHORT rasterize

0 | 1

do not rasterize | rasterize

USHORT banner

0 do not print the banner

1 print the banner

USHORT center

0 do not center the output on the page

1 center the output on the page

USHORT dither

0 do not dither the output

1 dither the output. Use only if bilevel equals 1.

USHORT bilevel

0

1

do not print as black-and-white

print as black-and-white

USHORT scale

IN_SCALE_MODE_*

TO_FIT (1) print to fit on page

ACTUAL_SIZE (2) print at actual size

HALF_PAGE (3) print to fit on half a page

NO_SCALE (4) no scaling

ACTUAL_SIZE_OR_FIT (5)
actual size or to fit

USHORT orientation

IN_ORIENT_BEST_FIT (1)

IN_ORIENT_PORTRAIT (2)

IN_ORIENT_LANDSCAPE (3)

IN_ORIENT_MIN_LENGTH (4)

IN_BOOL bWriteToINI

FALSE do not save these values to the INI file

TRUE save these values to the INI file

Remarks

This function will be obsoleted in a future release so we strongly recommend that you use IN_SetPrintOptionsEx (a new Print Extended function) instead of using this function.

Release information

Added to Imagenation for Windows in Release 4.1x.

Not supported in Imagenation for UNIX.

See also

Defining print options

Printing a document

Using CFG and INI files