<< Click to Display Table of Contents >> BkgGradientPrint |
[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.