ESRI.ArcGIS.ADF.Tasks
QualitySettings Property
See Also 
ESRI.ArcGIS.ADF.Tasks Namespace > PrintTask Class : QualitySettings Property




Settings for the quality of map when printing, including the drop-down list in the user dialog to select map quality.

Syntax

Visual Basic (Declaration) 
<DesignerSerializationVisibilityAttribute()>
<ResCategoryAttribute("PrintTask")>
<ResDescriptionAttribute("Settings for the Map Quality.")>
<NotifyParentPropertyAttribute(True)>
Public Property QualitySettings As QualityItemSettings
Visual Basic (Usage)Copy Code
Dim instance As PrintTask
Dim value As QualityItemSettings
 
instance.QualitySettings = value
 
value = instance.QualitySettings
C# 
[DesignerSerializationVisibilityAttribute()]
[ResCategoryAttribute("PrintTask")]
[ResDescriptionAttribute("Settings for the Map Quality.")]
[NotifyParentPropertyAttribute(true)]
public QualityItemSettings QualitySettings {get; set;}

Remarks

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.

See Also

© 2010 All Rights Reserved.