Description
Includes the map legend in the print output.
The Legend control works with 2D maps only. If you print a 3D web scene from a Web AppBuilder app, the Legend control will be blank.
In order for a layer to show in the legend:
▪The layer must be visible, that is, the layer's visibility must be turned on and the layer must be visible at the scale at which the map is printed.
▪The layer must be configured to show in the legend.
The method you use to include the layer in the legend depends on how the map was created:
•Geocortex Essentials: To include a layer from a Geocortex Essentials map, edit the layer in Geocortex Essentials Manager and select the Include in Legend checkbox on the layer's Details tab. Alternatively, configure the setting in the layer's drop-down menu.
•ArcGIS: To include a layer from an ArcGIS web map, edit the map in ArcGIS, open the map's Content panel, click the More Options icon, and click Show in Legend.
The legend fills the space provided by the Legend control. If the control isn't large enough to show the entire legend, the legend will be cut off.
Properties Common to Most Controls
For more information about the properties listed below, see Properties Common to Most Controls.
▪Actions: Align to Grid, Size to Grid, Center Horizontally, Center Vertically, Bring to Front, Send to Back, Fit Bounds to Container
▪Styles: Even Style, Odd Style, Style
▪Appearance: Background Color, Border Color, Border Dash Style, Border Width, Borders, Font Name, Font Size, Font Unit, Font Effects, Foreground Color, Padding
▪Behavior: Can Publish, Keep Together, Visible
▪Data: Tag
▪Design: Name
▪Layout: Location, Size
▪Navigation: Bookmark, Parent Bookmark, Navigation URL
For more information regarding each of the property groups, see the Control Reference.
Actions
Enable Smart Filter |
Type: Boolean Sets whether legend symbols that do not appear in the printed map are shown in the legend. In order for a layer's symbols to be filtered: ▪The layer must be a feature layer or a layer from a dynamic or tiled map service. The symbols for other layer types, such as imagery layers, are not filtered. ▪If the layer is from a dynamic or tiled map service, the layer must have a simple or unique value renderer defined for it. The symbols for layers with other types of renderers, such as class breaks renderers, are not filtered. ▪If the layer has a unique value renderer, the renderer's values must correspond to the values of the feature attribute. If the values do not correspond, the layer's symbols are not filtered. ▪Layers from a dynamic or tiled map service must allow query operations. VertiGIS Studio Printing queries the layer to determine which features are visible in the extent being printed. If the layer does not allow query operations, the layer's symbols are not filtered. ▪Every layer in the service must have a simple or unique value renderer. Smart Filtering increases the time it takes for prints to generate. |
Appearance
Note that the Legend control does not support the following settings:
▪Underline setting in Appearance | Font
▪Strikethrough setting in Appearance | Font
Behavior
Keep Together |
Type: Boolean Sets whether an item can be split horizontally across pages. When false, the print item will be split across pages if all its contents do not fit on one page. When true, the contents of the item will be printed, as a whole, on the next page. |
Printing
Right to Left |
Specifies the layout of the content within a print item. The options include: ▪Inherit: The item inherits the printing configuration set at the parent level. This is the default. ▪Yes: The content is aligned to the right. ▪No: The content is aligned to the left. |
Related Tutorials
Refer to the following resources for additional help on implementing this control:
▪Expressions
