![]() ![]() |
ESRI.ArcGIS.ADF.Tasks | |
QualitySettings Property | |
See Also Send Feedback |
ESRI.ArcGIS.ADF.Tasks Namespace > PrintTask Class : QualitySettings Property |
Visual Basic (Declaration) | |
---|---|
<ResDescriptionAttribute("Settings for the Map Quality.")> <ResCategoryAttribute("PrintTask")> <NotifyParentPropertyAttribute(True)> <DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility.Content)> Public Property QualitySettings As QualityItemSettings |
Visual Basic (Usage) | ![]() |
---|---|
Dim instance As PrintTask Dim value As QualityItemSettings instance.QualitySettings = value value = instance.QualitySettings |
C# | |
---|---|
[ResDescriptionAttribute("Settings for the Map Quality.")] [ResCategoryAttribute("PrintTask")] [NotifyParentPropertyAttribute(true)] [DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility.Content)] public QualityItemSettings QualitySettings {get; set;} |
A QualityItemSettings object stores settings for aspects of the PrintTask dialog and print page relating to quality of the printed map. The QualitySettings includes three properties that determine how the print task displays and handles quality of the map:
- DisplayInDialog: whether the Quality drop-down list is visible on the user dialog.
- DefaultValue: the default value for map print quality. If DisplayInDialog is false, then the setting in DefaultValue will determine the print map quality.
- QualityList: the collection of QualityItems that are displayed in the quality drop-down list if DisplayInDialog is true.
The quality of the map is based on the density of pixels on the printed map, measured as pixels or dots per inch (DPI). The higher the DPI chosen for the map, the higher the map print quality. However, higher DPI settings also require the task to request a larger map image from the server. Larger maps require more server resources to generate. The default choices in the QualityList (up to 200 DPI) work for all standard map servers (ArcGIS Server, ArcIMS, etc.) with the default choices for size in WidthSettings (up to 5 inches). If larger maps are requested by creating higher DPI settings or larger width settings, the map server's maximum size may be exceeded, and the map may not be produced. For more information, see the Developer Help discussion on the PrintTask.
Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family