This property sets the vertical printer resolution.
Property Value
Positive values represent the number of pixels per inch (DPI). The following negative values are supported:
| Value | Explanation |
|---|---|
| -1 | The resolution for printing a draft (DMRES_DRAFT) |
| -2 | Low print resolution (DMRES_LOW) |
| -3 | Medium print resolution (DMRES_MEDIUM) |
| -4 | High print resolution (DMRES_HIGH) |
( ) The explanation contained in the parentheses has the same meaning as the constants used by WindowsAPI.
Explanation
The YResolution property sets the vertical printer resolution. If the XResolution property value is set to 0 or lower than 0, then the value of the YResolution property will be ignored. To retrieve the YResolution property value, first execute the GetDevModeHandle or GetDevModeInfo method, after which the value can be retrieved from the YResolution property. To set the value of the YResolution property, execute the SetDevModeInfo method.
Note: The YResolution setting is dependent upon the printer driver. Because of this, it is possible that the setting has no affect or an affect different than expected. For details about printing orientation, please refer to the printer manufacturer's manual.
Also, when the PrintCreateDC or PrintDialog methoda are executed and the device context is created, the resolution is set accordingly.
Setting this value
This value can be set at runtime.
Retrieving this value
This value can be retrieved at runtime.
[Differences with ImageKit 7/8/9 ActiveX/VCL]
When the PrintCreateDC or PrintDialog method are executed and the device context is created, the resolution is set accordingly.