<dvt:stockGraph>

Specifies path to an XML file that contains settings for graph properties that are not exposed in the areaGraph tag.
For example, /myfiles/graph.xml
Path from web application root must be provided.

Specifies a binding reference to store a specific instance of UIGraph from a backing bean. Set this attribute only to access code in a backing bean. For example, to reference a graph component in the SampleGraph class, use the following code: binding="#{sampleGraph.graph}"

    public void clickListener (ClickEvent event){
        ComponentHandle handle = event.getComponentHandle();
        System.out.println(handle.getName()+" is clicked.");
    }
        

Specifies custom layout information when the graph automatically places and sizes its components. Valid values are:

• CL_NONE - Do not use any of the other custom layout attribute values
• CL_TITLES_SIDEBYSIDE - Display Title and subtitle side by side instead of the subtitle below the title
• CL_TITLE_SEPARATOR - Display title separator under the titles

• TLT_NONE - No group information appears in tooltips.
• TLT_MEMBER - (Default) Only the dimension member for a group appears in tooltips.
• TLT_DIM_MEMBER - Both dimension name and dimension member for a group are displayed in tooltips.

• Must not be a zero-length String.
• First character must be an ASCII letter (A-Za-z) or an underscore ('_').
• Subsequent characters must be an ASCII letter or digit (A-Za-z0-9), an underscore ('_'), or a dash ('-').

Specifies the format of graph image. Valid values are:

• PNG - PNG image format.
• FLASH - FLASH image format.
• PNG_STAMPED - PNG image with no javascript. This must be used when using graph in ADF table cells via stamping.
• AUTO - (Default) Generates Flash if a supported Flash player is found on the client. Otherwise, PNG image will be generated.

The default height is 300 pixels.

The default width is 400 pixels.

The markerTooltipTemplate attribute accepts a String that may contain any number of a set of predefined tokens. When the tooltips are generated, the tokens are replaced with the information corresponding to each marker. Valid tokens are:

• NEW_LINE - inserts a new line
• SERIES_LABEL - the series label for the series of this marker
• GROUP_LABEL - the group label for the group of this marker
• X_VALUE - the X value of a scatter or bubble marker
• Y_VALUE - the Y value of this marker (if this marker has a y value)
• Z_VALUE - the Z value (bubble size) of a bubble marker
• PIE_VALUE - the value of a pie slice
• PIE_PERCENT - pie slice percentage value
• ACTUAL_VALUE - the actual value for a funnel slice
• TARGET_VALUE - the target value for a funnel slice
• HIGH_VALUE - the high value for a stock marker
• LOW_VALUE - the low value for a stock marker
• CLOSE_VALUE - the close value for a stock marker
• OPEN_VALUE - the open value for a stock marker
• VOLUME_VALUE - the volume value for a stock volume marker
• CUM_VALUE - the cumulative stacked value for a stacked graph
• CUM_PERCENT - the cumulative percentage value for a stacked percent graph, pareto graph

• MTT_NONE - Displays no tooltips for markers.
• MTT_CUM_VAL - Displays the cumulative data value (stacked graphs only).
• MTT_PERCENT_VAL - Displays the percentage data value (pie slice only).
• MTT_PERCENT_VAL_TEXT - Displays the percentage data value (pie slice only) and text identification such as "January, Shoes".
• MTT_PERCENT_VAL_VALUES - Displays the percentage data value (pie slice only) and data value or values.
• MTT_PERCENT_VAL_VALUES_TEXT - Displays the percentage data value (pie slice only), data value or values, and text identification information such as "January, Shoes".
• MTT_TEXT - Displays text identification such as "January, Shoes".
• MTT_VALUES - (Default) Displays data value or values.
• MTT_VALUES_TEXT - Displays data value or values and text identification such as "January, Shoes".

Indicates whether an action can be performed through a partial page submit. Valid values are:

• "true" - (Default) Partial page submit is allowed.
• "false" - No partial page submit.

    public void scrollListener (ScrollEvent event){
        double zoomMin = event.getAxisMin(ScrollEvent.Y1AXIS);
        double zoomMax = event.getAxisMax(ScrollEvent.Y1AXIS);
        int groupStart = event.getAxisStartGroup(ScrollEvent.O1AXIS);
        int groupCount = event.getAxisGroupCount(ScrollEvent.O1AXIS); 
        System.out.println("Y1 Axis has a range from "+Double.toString(zoomMin)+" to "+Double.toString(zoomMax));
        System.out.println("O1 Axis has starting group index of "+Integer.toString(groupStart)+", and a group count of "+Integer.toString(groupCount));
    }
        

Determines the series effect that is used for a graph. Valid values are:

• SE_NONE - No series effect is used for the graph. This value causes markers to appear flat and sets the graphicAntialiasing attribute to "false".
• SE_GRADIENT - Sets a special gradient on data markers to make them look more polished and sets graphicAntialiasing to "true".
• SE_AUTO_GRADIENT - (Default) Works similar to SE_GRADIENT except in the case of a large dataset. If the graph displays a large dataset, then the gradient is not displayed in data markers so that peformance is improved.

Specifies the behavior when the mouse rolls over one bar in a series. Valid values are:

• RB_NONE - (Default) No series rollover behavior is enabled.
• RB_HIGHLIGHT - Highlights all bars in the series when rollover occurs.
• RB_DIM - Dims all bars in the series when rollover occurs
• RB_HIGHLIGHT | RB_DIM - Produces both highlighting and dimming of all bars in the series when rollover occurs.

• TLT_NONE - Displays no series information
• TLT_MEMBER - (Default) Displays the member label of the series in a tooltip
• TLT_DIM_MEMBER - Displays the dimension member label of a series in a tooltip

Applies a style to the graph based on the specified XML file. Valid values are the name of a standard graph style or the path of a custom XML file that you want to set as a style for this graph.

Predefined graph styles are:

• April
• Autumn
• Black and White
• Comet
• Confetti
• Default
• Earth
• Executive
• Financial
• Glass
• Nautical
• Projection
• Regatta
• Southwest
• Transparent

To specify a custom style, enter the entire path to the xml file. For example: /text/myStyle.xml.

Specifies the type of graph. Valid values are:

• STOCK_CANDLE - Candle open-close stock graph
• STOCK_CANDLE_VOLUME - Candle open-close stock with volume
• STOCK_HILO_CLOSE - High-low-close stock graph
• STOCK_HILO_CLOSE_VOLUME - High-low-close stock graph with volume
• STOCK_OHLC_CANDLE - Candle open-high-low-close stock graph
• STOCK_OHLC_CANDLE_VOLUME - Candle open-high-low-close stock graph with volume
• STOCK_OPEN_HILO_CLOSE - Open-high-low-close stock graph
• STOCK_VOLUME - Open-high-low-close stock graph with volume

Specifies a list of data that the graph uses to create a grid and populate itself. The List consists of a three-member Object array for each data value to be passed to the graph. The members of each array must be organized as follows:

• The first member (index 0) is the column label, in the grid, of the data value. This is generally a String. If the graph has a time axis, then this should be a Java Date. Column labels typically identify groups in the graph.
• The second member (index 1) is the row label, in the grid, of the data value. This is generally a String. Row labels appear as series labels in the graph (usually in the legend).
• The third member (index 2) is the data value, which is usually a Double.

• CTAI_AUTOMATIC - (Default) Graph calculates the interval automatically.
• CTAI_YEAR - Sets the interval to years.
• CTAI_MONTH - Sets the interval to months.
• CTAI_DAY - Sets the interval to days.
• CTAI_HOUR - Sets the interval to hours.
• CTAI_MINUTE - Sets the interval to minutes.
• CTAI_SECOND - Sets the interval to seconds.

The following types of time axis data are supported:

• Discrete - Observations are usually spaced at regular intervals.
• Continuous - Observations occur at any instant of time. There are two types of continuous time axis data:
  • Irregular - Multiple series of data have observations at the same instants of time.
  • Mixed frequency - Each series has observations at different instants of time.

The constants that specify time axis type also indicate the expected behavior when the requirements for a particular time axis type are not met. The following kinds of behavior are possible:

• Fallback position - For these constants, if the requirements for a time axis type are not met, then the graph degrades gracefully.
• Strict position - For these constants (which are indicated by the suffix "_STRICT"), if the requrements for a particular time axis type are not met, then an error message is displayed and no fallback position is provided. To provide custom text for the error message, register oracle.dss.graph.DataErrorTextCallback with the UIGraph.

Valid values are as follows:

• TAT_DEFAULT - (Default) Provides a discrete time axis for bar, line, area, combination, or stock graphs and for all their subtypes, if the following requirements are met: (1) Dates must be on the group edge and (2) dates must occur at regular intervals. The discrete time axis is plotted on the ordinal axis, which is also known as the O1-axis. This constant provides the following fallback position if requirements are not met: Time axis is disabled and all labels are converted to strings.

• TAT_IRREGULAR - Provides a continuous time axis on the X-axis for bar, line, area, or combination graphs (only for subtypes dual-Y and split). Stacked graphs are not supported. Additional requirements are: (1) Dates must be on the group edge, (2) dates must occur at regular intervals (sorted or unsorted), and (3) Only one dimension (layer) can exist on the group edge, if the data is provided through DataAccess interface. This constant provides the following fallback position if requirements are not met: Dates (if present) are converted to strings, the time axis is disabled, and an AlertEvent is fired to all AlertListeners that are registered with the graph.

• TAT_MIXED_FREQUENCY - Provides a continuous time axis on the X-axis for bar, line, area, combination, or scatter graphs for subtypes dual-Y and split. Stacked graphs are not allowed. Additional requirements are: (1) Data cells should contain dates, (2) the data to be plotted along the X-axis should be of type Date, and (3) the data to be plotted along the Y-axis must be a number.

• TAT_DEFAULT_STRICT - Provides discrete time axis as described in TAT_DEFAULT except that no fallback position is available. If requirements are not met, then an error message is displayed.

• TAT_IRREGULAR_STRICT - Provides continuous time axis as described in TAT_IRREGULAR except that no fallback position is available. If requirements are not met, then an error message is displayed.

• TAT_MIXED_FREQUENCY_STRICT - Provides continuous time axis as described in TAT_MIXED_FREQUENCY except that no fallback position is available. If requirements are not met, then an error message is displayed.

• TAT_OFF - Turns off the time axis.

• TRM_OFF - (Default) Show all the data on the time axis.
• TRM_RELATIVE_LAST - Using relative time range from the last data point. The range can be set using the relativeTimeRange attribute. Suppose the time axis is showing Jan 2 - Jan 14 and we need only the LAST 7 days, then the following properties must be set: relativeTimeRange = (7 days in milliseconds).
• TRM_RELATIVE_FIRST - The usage is similar to TRM_RELATIVE_LAST. Using relative time range from the first data point. The range can be set using the relativeTimeRange attribute. Suppose the time axis is showing Jan 2 - Jan 14 and we need only the FIRST 7 days, then the following properties must be set: relativeTimeRange = (7 days in milliseconds).
• TRM_EXPLICIT - Used for setting explicit time range. On a time axis, you can specify an explicit time range to show up on the time axis using the following attributes: timeRangeStart and timeRangeEnd.

Also see the following related properties: relativeTimeRange, timeRangeStart, and timeRangeEnd.

Specifies the type or types of visualEffect to apply. Valid values are:

• NONE - Apply no visual effects
• AUTO (Default) - Apply visual effects automatically based on graph or gauge type.

    public void zoomListener (ZoomEvent event){
        double zoomMin = event.getAxisMin(ZoomEvent.Y1AXIS);
        double zoomMax = event.getAxisMax(ZoomEvent.Y1AXIS);
        int groupStart = event.getAxisStartGroup(ZoomEvent.O1AXIS);
        int groupCount = event.getAxisGroupCount(ZoomEvent.O1AXIS); 
        System.out.println("Y1 Axis has a range from "+Double.toString(zoomMin)+" to "+Double.toString(zoomMax));
        System.out.println("O1 Axis has starting group index of "+Integer.toString(groupStart)+", and a group count of "+Integer.toString(groupCount));
    }