<dvt:mapBarGraphTheme>

mapBarGraphTheme map bar graph theme

The Bar Graph Theme tag is used within the <dvt:map> tag to provide the ability to show statistics related to given locations on a map. This theme displays a bar graph at points to represent data values associated with those locations. For example, this tag might be used to display a bar graph at warehouse locations to show inventory levels at each warehouse.

When a Bar Graph Theme is created, default colors are assigned to the bars in the graph. These colors can be customized with built-in styles or by using the mapBarSeriesSet and the mapBarSeriesItem tags.

Only one Graph Theme (Bar or Pie) can be visible in a map at a given time

Model

The Bar Graph Theme uses an underlying model to abstract the data that gets displayed in the theme. The specific model class is oracle.adf.view.faces.bi.model.GeoMapDataModel . The GeoMapDataModel contains information about the location and data associated with each bar graph. The model can be set through the value attribute of the mapBarGraphTheme tag.

Bar Graph Styles

Styles can be applied to the Bar Graph Theme to customize the color scheme of the bars. This is done with the styleName attribute. This attribute can be set to either the name of one of the predefined styles or the path of a custom XML file that defines the desired style. To set the color of each bar individually, use the mapBarSeriesSet and mapBarSeriesItem tags.

In the example below, the Bar Graph Theme uses the predefined "Autumn" style

            <dvt:map ...map attributes...> 
              <dvt:mapBarGraphTheme id="mapBarGraphTheme1" themename="MAP_STATES_NAME"
                  locationColumn="POLYGON_NAME" value="#{backingBean.geoMapModel}" stylename="Autumn"/>
            </dvt:map>
            

Connection to Base Map Themes

The base map theme on which this Bar Graph Theme layer is based is specified by the themeName attribute. This base map theme must come from the same data source as the base map.

If you are using Oracle's hosted eLocation services to configure the Map component, the themeName attribute for this tag should be set to one of the following five choices:

• MAP_CONTINENTS_NAME
• MAP_COUNTIES_NAME
• MAP_COUNTRIES_NAME
• MAP_STATES_NAME
• MAP_STATES_ABBRV

Depending on the base map theme you choose your data model should have the corresponding polygon names. If you choose MAP_STATES_ABBRV then your data model must have state abbreviations for matching the rows with the appropriate polygons.

Legend Customization

By default, the ID of the mapBarGraphTheme is used as the label when that theme is displayed in the legend or in the Theme Selection dialog. However, each mapBarGraphTheme tag has the following attributes that serve as optional labels for the theme:

• shortLabel: Specifies a label for the theme when displayed in the map legend
• menuLabel: Specifies a label for the theme in the Theme Selection dialog

Selection

The Bar Graph Theme supports the ability to select one or more bar graphs on the map using the mapToolbar's rectangle/circle/polygon/point selection tools. When the user defines a selected area on the map, any of the bar graphs that fall within the selected area will be highlighted and the selectionListener will be fired.

Relationship with other tags

The <dvt:mapBarGraphTheme> tag is a child of the <dvt:map> tag

The <dvt:mapBarGraphTheme> tag can have the following children:

• <af:convertNumber>
• <dvt:mapBarSeriesSet>

Deprecated children:

• <dvt:numberFormat>

Events

Attributes

public void processMouseClick(MapClickActionEvent mapClickActionEvent) {
    if (mapClickActionEvent.getDataContent() != null)
    {
        DataContent dt = mapClickActionEvent.getDataContent();
        System.out.println ("Location Name: " + dt.getLocationName());
    }
        
    System.out.println("MouseX " + mapClickActionEvent.getMouseX()); 
    System.out.println("MouseY " + mapClickActionEvent.getMouseY());         
}
        

 public void processSelection(MapSelectionEvent mapSelectionEvent) {
     Iterator iterator = mapSelectionEvent.getIterator();
        
     while (iterator.hasNext())
     {
         DataContent dt = (DataContent)iterator.next();    
         String selectedLocation = dt.getLocationName();
         System.out.println (selectedLocation);
     }                        
}