In the Structure window, right-click the gauge background node and choose Insert

25-22 Web User Interface Developers Guide for Oracle Application Development Framework shapes graphic file. Scalable Vector Graphics SVG is the supported file format for creating custom shapes for gauges. After designing the gauge and exporting it to an SVG file, a designer can add information to identify, scale, and position the gauge shapes and components, and to specify other metadata used in processing. In the SVG file, gauge components are identified using an ID. For example, an SVG file with polygon id=indicator would be interpreted as using a polygon shape for the indicator component. To specify multiple shapes to create the desired visual for a component, the ID can be modified as in id=indicator_0, id=indicator_1, and id=indicator_2. Table 25–1 shows the gauge component IDs and their descriptions. Table 25–1 Gauge Component IDs for Custom Shapes ID Description indicator Points to the value represented by the gauge. If not specified, the gauge will use the indicator specified in the application. For the dial gauge, the indicator must be specified while pointing up 90 degrees, so that the shape can be properly rotated. For the status meter gauge, the indicator should be specified with its full extent, and the gauge will be cropped to point to the metric value. indicatorBase For a dial gauge, refers to the object that appears at the base of the indicator component. If specified, and the indicatorCenter is not, then the center of the indicatorBase will be taken as the indicatorCenter. gaugeFrame Refers to the optional component that adds visual distinction to the plotArea. It can be turned on or off in the application by setting the rendered property. Used primarily when the user wants to use the default gauge plotArea. If no plotArea is specified, then the gauge will insert the default plotArea within the plotAreaBounds. This provides a quick way to change the look of the gauge without having to create a custom plotArea or tickMark. lowerLabelFrame Refers to the frame that contains the bottomLabel when its position is LP_BELOW_GAUGE; allows the user to customize the look of this frame. The gauge will position the lowerLabelFrame in the same relative position to other gauge components when it is found in the custom shapes file. plotArea For the dial gauge, refers to the circular area within which the indicator moves. For the status meter gauge, refers to the area that contains the indicator. For the LED gauge, refers to the area that contains any graphics that will not be filled with the LED fill color. When a plotArea is not specified, the gauge will draw the default plotArea. For tick marks to be drawn, a specification of the plotArea also requires either tickMarkPath or a set of tick marks. Using ADF Gauge Components 25-23 Table 25–2 shows the metadata IDs and the descriptions used for internal calculations, not rendered in the gauge. tickMark Used to define increments on the gauge. When a set of tick marks is specified with no tickMarkPath, the gauge will use the tick marks exactly where they appear on the plotArea. In this case, it is up to the user to ensure that the tick marks appear at equal increments. If a tickMarkPath is specified, the gauge will accept a single tickMark, at 90 degrees for the dial, and it will rotate and position the tickMark along the tickMarkPath. upperLabelFrame Refers to the frame that contains the topLabel when its position is LP_ABOVE_GAUGE. Setting the upperLabelFrame allows the user to customize the look of this frame. The gauge will position the upperLabelFrame in the same relative position to other gauge components when it is found in the custom shapes file. Table 25–2 Metadata IDs for Custom Shapes ID Description indicatorBarBounds Specifies the box containing the minimum and maximum extent of the indicator bar. If not specified, the bounding box is taken to be the entire indicator as specified in the input file. indicatorCenter Specifies the center of rotation for the indicator that rotates around in a dial gauge. The center of the shape with this ID is considered to be the indicator center. If not specified, it is assumed to be the center of the bottom edge of the plot area for an 180-degree dial gauge, and the center of the plot area for an N-degree dial gauge. ledFillArea Specifies the area of the LED gauge that should be filled with the appropriate threshold color. If not specified, then the entire plotArea shape specified in the graphics file will be filled with the threshold color. lowerLabelFrameTextBox For complex lowerLabelFrame shapes, specifies a rectangle that can be set as the lowerLabelFrameTextBox. This box determines the position of the bottom label within the lowerLabelFrame. plotAreaBounds Specified the bounding box for the plotArea. If no plotArea has been specified in this file, then a bounding box is needed for the gauge to draw the plot area of the gauge. If not specified, then the gaugeFrame will use its own bounding box for this purpose. thresholdFillArea Defines the area that will be filled with the threshold colors. For a dial gauge, specifies the thresholdFillArea that will be filled by sweeping an arc from the indicatorCenter. For a status meter gauge, specifies the thresholdFillArea that will be filled based on the orientation of the status meter gauge. tickMarkPath Defines the path in which to draw tick marks. This is necessary for the gauge to calculate where tick marks should be drawn on a custom plot area, and the gauge will be unable to change the majorTickCount if this is not specified. Table 25–1 Cont. Gauge Component IDs for Custom Shapes ID Description