Oracle Fusion Middleware Data Visualization Tools Tag Reference for Oracle ADF Faces
12c (12.1.2)
E23187-01

<dvt:mapToolbar>

UIComponent class: oracle.adf.view.faces.bi.component.geoMap.UIGeoMapToolbar
Component type: oracle.dss.adf.geoMap.GeoMapToolbar

This component contains tools for turning on/off themes, selecting theme elements, zooming, calculating distance and area for the selected regions, displaying legend, and showing the spatial coordinates of the mouse location.

To use the map toolbar, you need to add the <dvt:mapToolbar> to your page, and set the mapId attribute to the id of the <dvt:map>. The mapToolbar tag is not a child tag of the map.

Map Tools

The mapToolbar contains the following set of tools:

"Pan" - Let users pan the map by drag and drop
"Zoom In" - Let users zoom in one level down the map
"Zoom Out" - Let users zoom out one level up the map
"Rectangle Tool" - Let users to make a rectangle selection on the map. Theme elements that are within the rectangle will be highlighted
"Circle Tool" - Let users to make a circle selection on the map. Theme elements that are within the circle will be highlighted
"Polygon Tool" - Let users to make a polygon selection on the map. Theme elements that are within the polygon will be highlighted
"Point Tool" - Let users to make a point selection on the map. Theme elements that are within the point will be highlighted
"Distance Tool" - Let users to draw a line and find the distance of the line
"Area Tool" - Let users to draw a polygon and find the area of the region
"Leged Tool" - Show/hide the legend
"Info Area Tool" - Show/hide the information area

Relationship with other tags

The <dvt:mapToolbar> tag is used in conjunction with the <dvt:map> tag.

Geometry Management

This component can be stretched horizontally by a parent layout component that stretches its children, e.g. panelStretchLayout, panelSplitter.
When NOT stretched, this component will be displayed in its default dimensions which are provided by the skin. This can be modified by applying a dimension using the inlineStyle or AFStretchWidth attributes.
This component does not stretch its children.

Screen Shot(s)

No image.

Events

Type	Phases	Description
org.apache.myfaces.trinidad.event.AttributeChangeEvent	Invoke Application, Apply Request Values	Event delivered to describe an attribute change. Attribute change events are not delivered for any programmatic change to a property. They are only delivered when a renderer changes a property without the application's specific request. An example of an attribute change event might include the width of a column that supported client-side resizing.

Attributes

Name	Type	Supports EL?	Description
attributeChangeListener	javax.el.MethodExpression	Only EL	a method reference to an attribute change listener. Attribute change events are not delivered for any programmatic change to a property. They are only delivered when a renderer changes a property without the application's specific request. An example of an attribute change events might include the width of a column that supported client-side resizing.
binding	String	Only EL	a binding reference to store the UIGeoMapToolbar instance
id	String	Yes	The identifier for the component
mapId	String	Yes	The id of the map component that is associated with this toolbar. If the map does not exist, the toolbar will not work, and an exception will be thrown.
partialTriggers	String	Yes	Specifies the ids of the components that should trigger a partial update. This component will listen on the trigger components. If one of the trigger components receives an event that will cause it to update in some way, this component will request to be updated too.
rendered	boolean	Yes	Default Value: true whether the component is rendered. When set to false, no output will be delivered for this component (the component will not in any way be rendered, and cannot be made visible on the client). If you want to change a component's rendered attribute from false to true using PPR, set the partialTrigger attribute of its parent component so the parent refreshes and in turn will render this component.
showDistanceTools	boolean	Yes	Default Value: true Specifies wheter distance tool and area tool will be shown on the toolbar. The default value is true.
showSelectThemeDialog	boolean	Yes	Default Value: true Specifies whether select theme dialog will be visible on the view menu of the toolbar. The default value is true.
showSelectThemeMenuItem	boolean	Yes	Default Value: true Specifies whether "select theme" menu item will be visible on the view menu of the toolbar. The default value is true.
showSelectionTools	boolean	Yes	Default Value: true Specifies whether selection tools - rectangle tool, circle tool, polygon tool, and point tool - will be shown on the toolbar. The default value is true.
showViewMenu	boolean	Yes	Default Value: true Specifies whether view menu will be shown on the toolbar. The default value is true.
showZoomTools	boolean	Yes	Default Value: true Specifies whether zoom in tool and zoom out tool will be shown on the toolbar. The default value is true.
styleClass	String	Yes	Sets a CSS style class to use for this component.