This property sets the horizontal 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 XResolution property sets the horizontal printer resolution. If this property value is set to 0 or lower than 0, then the value of the YResolution property will be ignored. To retrieve the XResolution property value, first execute the GetDevModeHandle or GetDevModeInfo method, after which the value can be retrieved from the XResolution property. To set the value of the XResolution property, execute the SetDevModeInfo method.
Note: The XResolution 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.