Gauge Terminology Introduction to the Gauge Component

Using ADF Gauge Components 25-9 To create a gauge that uses tabular data from a managed bean: 1. In the ADF Data Visualizations page of the Component Palette, Gauge panel, drag and drop a Gauge onto the page. 2. In the Component Gallery, select the category, type, and quick-start layout style for the gauge that you are creating.

3. In the Gauge Data category of the Property Inspector, from the tabularData

attribute dropdown menu, choose Expression Builder. 4. In the Expression Builder dialog, use the search box to locate the managed bean. 5. Expand the managed bean node and select the method that creates the list of tabular data.

6. Click OK.

The Expression is created. For example, if the name of the managed bean is sampleGauge and the name of the method that creates the list of tabular data is getGaugeData, the Expression Builder generates the code {sampleGauge.gaugeData} as the value for the tabularData attribute of the dvt:gauge tag.

25.3.3 What Happens When You Create a Gauge Using Tabular Data

When you create a gauge tag that is powered by data obtained from a list referenced in the tabularData attribute, the following results occur: ■ A gauge is generated with a setting in its tabularData attribute. The settings for all other attributes for this gauge are provided by default. ■ You have the option of changing the setting of the gaugeType attribute in the Property Inspector to DIAL, LED, STATUSMETER, or VERTICALSTATUSMETER.

25.4 Customizing Gauge Type, Layout, and Appearance

Gauge components can be customized in the following ways: ■ Change the gauge type ■ Specify the layout of gauges in a gauge set ■ Change a gauge size and style ■ Add thresholds ■ Format numbers and text ■ Specify an N-degree dial gauge ■ Customize gauge labels ■ Customize indicators and tick marks ■ Specifying transparency in gauges

25.4.1 How to Change the Type of the Gauge

You can change the type of a gauge using the gaugeType attribute of the dvt:gauge tag. The gauge type is reflected in the visual editor default gauge. 25-10 Web User Interface Developers Guide for Oracle Application Development Framework To change the type of a gauge: 1. In the Structure window, right-click the dvt:gauge node and choose Go to Properties .

2. In the Property Inspector, choose a gauge type from the GaugeType attribute

dropdown list. Valid values are DIAL, LED, STATUSMETER, or VERTICALSTATUSMETER.

25.4.2 How to Determine the Layout of Gauges in a Gauge Set

A single gauge can display one row of data bound to a gauge component. A gauge set displays a gauge for each row in multiple rows of data in a data collection. You can specify the location of gauges within a gauge set by specifying values for attributes in the dvt:gauge tag. To specify the layout of gauges in a gauge set: 1. In the Structure window, right-click the dvt:gauge node and choose Go to Properties .

2. In the Property Inspector, select the Common attributes category.

3. To determine the number of columns of gauges that will appear in a gauge set, specify a value for the gaugeSetColumnCount attribute. A setting of zero causes all gauges to appear in a single row. Any positive integer determines the exact number of columns in which the gauges are displayed. A setting of -1 causes the number of columns to be determined automatically from the data source. 4. To determine the placement of gauges in columns, specify a value for the gaugeSetDirection attribute. If you select GSD_ACROSS, then the default layout of the gauges is used and the gauges appear from left to right, then top to bottom. If you select GSD_DOWN, the layout of the gauges is from top to bottom, then left to right. 5. To control the alignment of gauges within a gauge set, specify a value for the gaugeSetAlignment attribute. This attribute defaults to the setting GSA_NONE, which divides the available space equally among the gauges in the gauge set. Other options use the available space and optimal gauge size to allow for alignment towards the left or right and the top or bottom within the gauge set. You can also select GSA_CENTER to center the gauges within the gauge set.

25.4.3 Changing Gauge Size and Style

You can customize the width and height of a gauge, and you can allow for dynamic resizing of a gauge based on changes to the size of its container. You can also control the style sheet used by a gauge. These two aspects of a gauge are interrelated in that they share the use of the gauge inlineStyle attribute.

25.4.3.1 Specifying the Size of a Gauge at Initial Display

You can specify the initial size of a gauge by setting values for attributes of the dvt:gauge tag. If you do not also provide for dynamic resizing of the gauge, then the initial size becomes the only display size for the gauge.