Creating Exterior Tick Labels

25-20 Web User Interface Developers Guide for Oracle Application Development Framework Example 25–8 Sample Backing Bean Code public String altoracle.dss.dataView.ComponentHandle handle { return handle.getName; } public String onClickoracle.dss.dataView.ComponentHandle handle { return document.title=\onClick\;; } public String onMouseMoveoracle.dss.dataView.ComponentHandle handle { return document.title=\onMouseMove\;; } The following gauge subcomponents support the dvt:shapeAttributes tag: ■ GAUGE_BOTTOMLABEL - the label below the gauge ■ GAUGE_INDICATOR - the indicator in the gauge ■ GAUGE_LEGENDAREA - the legend area of the gauge ■ GAUGE_LEGENDTEXT - the text label of the legend area ■ GAUGE_METRICLABEL - the label showing the metric value ■ GAUGE_TOPLABEL - the label above the gauge ■ GAUGE_PLOTAREA - the area inside the gauge ■ GAUGE_THRESHOLD - the threshold area of the gauge

25.5.4 How to Animate Gauges

You can animate gauges not gauge sets to show changes in data, for example, a dial gauge indicator can change color when a data value increases or decreases. Figure 25–10 shows a dial gauge with the dial indicator animated to display the data change at each threshold level. Figure 25–10 Animated Dial Gauge The attributes for setting animation effects on gauges are: ■ animationOnDisplay: Use to specify the type of initial rendering effect to apply. Valid values are: – NONE default: Do not show any initial rendering effect. – AUTO: Apply an initial rendering effect automatically chosen based on graph or gauge type. ■ animationOnDataChange: Use to specify the type of data change animation to apply. Valid values are: – NONE: Apply no data change animation effects. – AUTO default: Apply Active Data Service ADS data change animation events. For more information about ADS, see Section 25.5.5, How to Animate Gauges with Active Data. Using ADF Gauge Components 25-21 – ON: Apply partial page refresh PPR data change animation events. Use this setting to configure the application to poll the data source for changes at prescribed intervals.

25.5.5 How to Animate Gauges with Active Data

Animation effects using Active Data Service ADS can be added to dial and status meter gauge types. ADS allows you to bind ADF Faces components to an active data source using the ADF model layer. To allow this, you must configure the components and the bindings so that the components can display the data as it is updated in the data source. Before you begin: In order to use the Active Data Service, you must: ■ Have a data source that publishes events when data is changed ■ Create business services that react to those events and the associated data controls to represent those services For more information about ADS and configuring your application, see the Using the Active Data Service chapter in the Oracle Fusion Middleware Fusion Developers Guide for Oracle Application Development Framework.

25.5.5.1 Configuring Gauge Components to Display Active Data

You configure a databound gauge to display active data by setting a value on the binding element in the corresponding page definition file. To configure a gauge to display active data: 1. In the Structure window, right-click the gauge node, and choose Go To Properties. 2. In the Property Inspector, enter a unique value in the ID field. If you do not select an identifier, one will be entered for you. 3. Open the page’s associated page definition file. 4. In the Structure window for the page definition file, select the node that represents the attribute binding for the component. In the Property Inspector, select Push for the ChangeEventPolicy attribute.

25.5.5.2 Adding Animation to Gauges

After configuring the gauge component to display active data, set animation effects using the attributes defined in Section 25.5.4, How to Animate Gauges.

25.6 Using Custom Shapes in Gauges

You can directly specify the graphics for a gauge to create custom gauge shapes. The customShapesPath attribute is set to point to the vector graphics file that is processed into graphics used for output. JDeveloper also provides a set of custom shape styles accessible by using the customShapesPath attribute.

25.6.1 How to Create a Custom Shapes Graphic File

Due to the requirements for rotating and resizing a gauge’s components, such as the plot area or tick marks, a vector graphics file is required when creating a custom