|ButtonText||String||The text which appears on the button to executes the task.|
|LegendSettings||LegendItemSettings||Settings for printing the legend in the print page.|
|MapSettings||ItemSettings||Settings for whether the map prints.|
|NorthArrowSettings||NorthArrowSettings||Settings for printing the north arrow on the print page.|
|QualitySettings||QualityItemSettings||Settings for the quality (DPI) of the map on the print page.|
|ResultsVisible||Boolean||Whether the list of task results displays in the print dialog, enabling the user to print task results.|
|ScaleBarSettings||ItemSettings||Settings for whether the scalebar displays on the print page.|
|TitleSettings||ItemSettings||Settings for the title on the print page.|
|WidthSettings||WidthItemSettings||Settings for the size (based on the width) of the map on the print page.|
|ActivityIndicatorImage||String||URL of the image to display while a task is executing.|
|ActivityIndicatorLocation||TaskActivityIndicatorLocation||The location of an animated image that is displayed while the task is executing.|
|NavigationPath||String||The path to the task as it would appear in a hierarchical data control buddied to the task's TaskManager.|
|Map||String||ID of the Map control that will be used as the source for the printed map.|
|MapCopyrightText||String||ID of the MapCopyrightText control to use for printing a copyright statement on the printed page.|
|TaskResultsContainers||BuddyControlCollection||The controls in which results from this task are displayed.|
|LayoutTemplateFile||String||The path to the file specifying the layout of the print page.|
If you change the North arrow character displayed on the Map, either when creating the application in Manager, or in Visual Studio, then you can use the index character number to set the character number for the Print Task's north arrow.
In the case of the page size and print quality, the text shown above (i.e., small, medium, large; draft, and normal) will display in the print dialog that appears when the end user of your application wants to print the map. You can change these values in Visual Studio by editing the appropriate properties on the Print Task: WidthSettings, QualitySettings, and NorthArrowSettings. However, you have to set these properties for every Web application you create.
The Print Task uses a configuration file to store the predefined values. Thus, if you want to replace these values with your own values, you can do so by editing the configuration file in a text editor. Any newly created applications will then use the new predefined values.
The configuration file is located in the folder <install_location>/Dotnet and is called ESRI.ArcGIS.ADF.Tasks.dll.config. To change the page size or print quality names that display (e.g., small, draft), you will need to add a new attribute called Name. This will override the current predefined value, which is stored in a resource file for localization purposes. For example, here is one entry for the page size with Name added:
<Size ID="PrintTaskSize0" Name=”Small Map” SizeHeight="3.0" SizeWidth="3.0" Unit="Inches" />
When setting the page size and quality, keep in mind that the GIS server imposes limits on the maximum image size it can return. For example, ArcGIS Server map services, by default, restrict the image size to a maximum of 2048 x 2048 pixels. This means that a 10 inch square map with a quality of 200 dpi is 2000 x 2000 pixels. If the print task map request exceeds the limits of the GIS server, the particular service will not print.