BkgGradientPrint

<< Click to Display Table of Contents >>

Navigation:  Drawing Functions >

BkgGradientPrint

Previous pageReturn to chapter overviewNext page

[Not supported by the Community Edition]

Because gradients drawn on b/w printers waste toner (or ink) and might make text and other things in the foreground unreadable, you can specify how gradients are printed. This property does not affect how gradients are drawn in the preview.

property integer VPE.BkgGradientPrint

write; runtime only

Possible Values:

ActiveX / VCL

Value

Enum

Comment

VGRD_PRINT_AUTO

0

Auto

if printer is a color printer, the gradient is printed, otherwise the alternate solid color is used

VGRD_PRINT_GRADIENT

1

Gradient

the gradient is always printed

VGRD_PRINT_SOLID

2

Solid

the alternate solid color is always printed

Default:

VGRD_PRINT_AUTO

Remarks:

In contrast to all other graphical object properties, this property is valid for ALL objects in the document at once.

 

We experienced, that even some color printer drivers identify themselves as b/w printers (for example the Epson Stylus PHOTO 700 on Win-NT (driver v2.05) identifies itself as b/w printer, but the Epson Stylus Color ESC/P2 driver (shipped with Win-NT 4.0 SP 3) identifies itself as color printer).

 

Printer drivers are manufactured by vendors independent of IDEAL Software; we make no warranty, implied or otherwise, regarding these product’s performance or reliability.

 

If VPE should print on a color printer in VGRD_PRINT_AUTO mode gradients in b/w (so the printer driver identified itself wrongly as b/w printer), use VGRD_PRINT_GRADIENT instead.

Example:

ActiveX / VCL:

Doc.BkgGradientPrint = VGRD_PRINT_SOLID

Doc.BkgGradientPrintSolidColor = COLOR_LTGRAY

 

.NET:

Doc.BkgGradientPrint = BkgGradientPrint.Solid

Doc.BkgGradientPrintSolidColor = Color.LightGray

Will force VPE to draw a very light grey color in the background of gradient objects when they are printed.

 

ActiveX / VCL:

Doc.BkgGradientPrint = VGRD_PRINT_AUTO

Doc.BkgGradientPrintSolidColor = Color.LightGray

 

.NET:

Doc.BkgGradientPrint = BkgGradientPrint.Auto

Doc.BkgGradientPrintSolidColor = Color.LightGray

VPE will check the printer during the print job, if it is a color printer. If so, the gradients are drawn. Otherwise VPE will draw a very light grey color in the background of gradient objects when they are printed.