|
<< Click to Display Table of Contents >> DevPrintQuality |
  
|
|
<< Click to Display Table of Contents >> DevPrintQuality |
|
[Windows platform only; not supported by PHP and the Community Edition]
Returns / sets the print quality of the currently selected output device to the specified value or it sets the x-resolution in DPI.
property DevPrintQuality [integer] VPE.DevPrintQuality
read / write; runtime only
Possible Values:
ActiveX / VCL |
Value |
Enum |
Comment |
VRES_DRAFT |
-1 |
Draft |
Draft Quality |
VRES_LOW |
-2 |
Low |
Low Quality |
VRES_MEDIUM |
-3 |
Medium |
Medium Quality |
VRES_HIGH |
-4 |
High |
High Quality |
If a positive value is given, it specifies the number of dots per inch (DPI) for the x-resolution and is therefore device dependent. If you are able to set DevYResolution without error, this property should specify the x-resolution in DPI.
Remarks:
In case of an error, LastError is set to VERR_COMMON. An error may occur if the device does not support setting the print quality or x-resolution. You should read this property’s value after setting it, to be sure the value has been accepted. Sometimes the value has not been accepted, but LastError returns no error state (= VERR_OK).
We experienced that some drivers do not allow setting the y-resolution, BEFORE the x-resolution had been changed and vice versa. Also some drivers only accept the same values for both resolutions.
Example:
ActiveX / VCL:
Doc.DevPrintQuality = VRES_DRAFT // Draft Mode
Doc.DevPrintQuality = 300 // 300 DPI
.NET:
Doc.DevPrintQuality = DevPrintQuality.Draft // Draft Mode
Doc.DevPrintQuality = (DevPrintQuality)300 // 300 DPI