mapPointTheme is a child tag of the map that let developers to create a point theme. The data for each mapPointTheme is abstracted in an instance of oracle.adf.view.faces.bi.model.GeoMapDataModel. The GeoMapDataModel is a collection of GeoRowObjects. Each GeoRowObject should have a GeoObject that contain the longitude and latitude of the location of the point to plot.
Developers can customize the appearance of each points through the customPointCallback attribute or the mapPointStyleItem tag, which is a child tag of the mapPointTheme. The mapPointStyleItem tag let developers to customize the image of the points. Developers can display different images based on the value of each point The customPointCallback attribute let developers to show custom HTML for each point. The customPointCallback attribute has higher priority than the mapPointStyleItem tag. Hence, if the customPointCallback attribute is specified, the mapPointStyleItem tags will be ignored.
The mapPointStyleItem tag can be used to override the default image of the mapPointTheme. For detail, please refer to the documentation of mapPointStyleItem tag.
The customPointCallback attribute let developers to show custom HTML for each point. The customPointCallback attribute should be a method expression that returns a oracle.adf.view.faces.bi.component.geoMap.PointContent and will take a oracle.adf.view.faces.bi.component.geoMap.DataContent as its parameter.
mapPointTheme tag can contain any number of mapPointStyleItem tag. MapPointStyleItem let developers to change the appearance of the point depends on its value or the category of the object. Developers can customize the image in normal mode, selected mode, or when the point is being hovered on.
This component can have the following children:
| Name | Type | Supports EL? | Description |
|---|---|---|---|
| id | java.lang.String | no | The identifier for the component |
| rendered | boolean | no | Specifies whether the theme is rendered or not |
| value | java.lang.String | no | Specifies the data model for theme - have to be an instance of oracle.adf.view.faces.bi.model.GeoMapDataModel |
| shortLabel | java.lang.String | no | Specifies the label of this theme on the legend. If the attribute is not specified, the id of the theme will be used as the label on the legend. |
| menuLabel | java.lang.String | no | Specifies the label of this theme on the ThemeSelectionDialog and SelectMenuItem. If the attribute is not specified, the id of the theme will be used. |
| builtInImage | java.lang.String | no |
Specifies the builit in images for this point style item. Each built in image has a set of normal images, selected images and hovered images Built in images are:
|
| defaultItemLabel | java.lang.String | no | Specifies the label of a point style on the legend. If no pointStyleItem is specified, the point theme will show the default point images for all the points in the theme. This attribute let the developers to customize the label of the the points on the legend when no pointStyleItem is specified |
| animationEffect | java.lang.String | no | the animationEffect to use for ADS |
| minZoom | int | no | Specifies the minimum zoom scale where this theme will still be visible. |
| maxZoom | int | no | Specifies the maximum zoom scale where this theme will still be visible. |
| selectionListener | java.lang.String | no | a method reference to a selection listener Refers to a backing bean method that takes MapSelectionEvent as an argument The MapSelectionEvent contains the information on the selected region. Sample code: 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); } } |
| clickAction | java.lang.String | no | Refers to a backing bean method that performs navigation processing for the map and returns an outcome String. Or a static outcome String can be specified. The JSF NavigationHandler selects the page to display next by matching the outcome String against the navigation rules in the application configuration resource file. The application writes the Navigation rules. |
| clickListener | java.lang.String | no | a method reference to a click listener Refers to a backing bean method that takes MapClickActionEvent as an argument The MapClickActionEvent contains the information on the clicked point. Sample code: 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()); } |
| leftClickBehavior | java.lang.String | no | Specifies the behavior when user left clicks on an element of a theme. Valid value of theme are:
|
| rightClickBehavior | java.lang.String | no | Specifies the behavior when user right clicks on an element of a theme. Valid value of theme are:
|
| useWindow | boolean | no | Specifies whether processes launched by this command should be launched in a secondary dialog window. 'useWindow' works only in the case of dialogs i.e, if the "action" starts with a "dialog:". Set useWindow to 'false' for the dialog to be opened in the existing window. |
| windowWidth | int | no | Specifies the width of the window if useWindow is true |
| windowHeight | int | no | Specifies the height of the window if useWindow is true |
| infoWindowCallback | java.lang.String | no | Specifies a callback for overriding the default text in the info Window. |
| customPointCallback | java.lang.String | no | Specifies a callback for overriding the point. The value of this attribute should be a method espression that returns a oracle.adf.view.faces.bi.component.geoMap.PointContent and will take a oracle.adf.view.faces.bi.component.geoMap.DataContent as its parameter.This callback lets developer show custom HTML for each point. The DataContent object contains all the necessary information for developers to determine what to show for a point. This attribute has a higher priority than the mapPointStyleItem. If this attribute is set, all the mapPointStyleItem tag will be ignored. |
| customLegendCallback | java.lang.String | no | Specifies a callback for displaying the legend if developers use customPointCallback for the pointTheme. |
| hoverBehavior | java.lang.String | no | Specifies the behavior when user hovers over a point on the pointTheme Valid value of theme are:
|