|
Oracle™ Business Intelligence Beans Java API Reference | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--oracle.dss.util.PagingControlAttributesAdapter | +--oracle.dss.dataView.UIDataviewAdapter | +--oracle.dss.graph.gui.UIGraphAdapter
UIGraph Adapter for a graph. Provides a proxy so that the user-interface panels can be displayed before a graph is constructed. To prevent memory leak, the application should call setDataSource(null)
on this object when this object is no longer being used.
Field Summary | |
static int |
NO_TIME_AXIS |
static int |
TIME_AXIS |
static int |
UNKNOWN |
Constructor Summary | |
UIGraphAdapter() Construct a graph adapter | |
UIGraphAdapter(Graph graph) Construct a graph adapter |
Method Summary | |
void |
applyToGraph(Graph graph) Apply properties of this adapter to a graph. |
void |
applyViewStyle(ComponentHandle componentHandle, ViewStyle viewStyle) Applies a ViewStyle to a page item. |
void |
beginAxisChanges() Prevents calculation of axis values while the user interface panel sets axis scaling properties. |
void |
cleanUp() Frees memory used by this adapter. |
void |
endAxisChanges() Re-enables calculation of axis values after the user interface panel sets axis scaling properties. |
int |
getAutoLayout() Retrieves information about when the graph automatically places and sizes its components. |
int |
getColumnCount() Retrieves the number of columns of data that this graph displays. |
ViewStyle |
getComponentViewStyle(ComponentHandle componentHandle) Retrieves the ViewStyle for a selected component. |
java.lang.Object |
getDataAccessSliceLabel(int edge, int slice, java.lang.String type) Retrieves the label for the data slice in the DataAccess for this graph. |
int |
getDataDirectorType() Retrieves the the type of the current DataDirector , either a cube data director, for multidimensional data, or a relational data director, for relational data. |
DataFilter |
getDataFilter() Retrieves an implementation of the DataFilter interface. |
DataSource |
getDataSource() Retrieves the data source for this view. |
int |
getGraphType() Retrieves the current graph type for this graph. |
GraphTypeConverter |
getGraphTypeConverter() Retrieves the GraphTypeConverter that this graph uses. |
int |
getGroupTooltipLabelType() Retrieves the type of information about groups that this graph displays in tooltips. |
int |
getMarkerTooltipType() Indicates the type of information that this graph displays in tooltips for markers. |
UIParetoLine |
getParetoLine() Retrieves the pareto line color. |
int |
getRowCount() Retrieves the number of rows of data that this graph displays. |
int |
getSeriesObjectCount() Retrieves the number of series that this graph stores properties for. |
int |
getSeriesTooltipLabelType() Retrieves the type of information about series that this graph displays in tooltips. |
int |
getTimeAxisData() Retrives if the data provided to Graph is time axis data |
interface |
getUIX1ReferenceLine() Retrieves an implementation of the UIReferenceLine interface that represents the X1ReferenceLine component of a graph. |
interface |
getUIY1ReferenceLine() Retrieves an implementation of the UIReferenceLine interface that represents the Y1ReferenceLine component of a graph. |
interface |
getUIY2ReferenceLine() Retrieves an implementation of the UIReferenceLine interface that represents the Y2ReferenceLine component of a graph. |
int |
getViewType() Get the specific type of this view. |
void |
initFromGraph(Graph graph) |
boolean |
isDataRowShownAsASeries() Indicates whether rows of data appear as series or as groups. |
boolean |
isGroupSeriesTooltipSupported(int edge) Indicates whether group or series option (depending on the edge passed in) is supported in the tooltips. |
boolean |
isHorizontal() Indicates whether the graph has a horizontal graph type. |
boolean |
isLineDataLineDisplayed() Indicates whether data lines appear in a line graph. |
boolean |
isMarkerDisplayed() Indicates whether data markers appear in a line graph. |
boolean |
isO1AxisSupported() Indicates whether the current graph type has an ordinal axis. |
boolean |
isPagingControlVisible() Indicate whether the paging control on the graph is visible. |
void |
setDataDirectorType(int type) Specifies the the type of DataDirector , either a cube data director, for multidimensional data, or a relational data director, for relational data. |
void |
setDataRowShownAsASeries(boolean yesNo) Specifies whether to display data rows as series or as groups. |
void |
setDataSource(DataSource dataSource) Specifies the data source for this graph. |
void |
setGraphType(int graphType) Specifies the graph type for this graph. |
void |
setGraphTypeConverter(GraphTypeConverter graphTypeConverter) Specifies the GraphTypeConverter for the graph type to use. |
void |
setGroupTooltipLabelType(int groupTooltipLabelType) Specifies the type of information about groups that this graph displays in tooltips. |
void |
setLineDataLineDisplayed(boolean bValue) Specifies whether data lines appear in a line graph. |
void |
setLocale(java.util.Locale loc) Sets the Locale that this UIGraphAdapter uses. |
void |
setMarkerDisplayed(boolean yesNo) Specifies whether data markers appear in a line graph. |
void |
setMarkerTooltipType(int markerTooltipType) Specifies the type of information that this graph displays in tooltips for markers. |
void |
setPagingControlVisible(boolean bValue) Specifies whether to display the paging control with the graph. |
void |
setSeriesObjectCount(int count) Specifies the number of series that this graph stores properties for. |
void |
setSeriesTooltipLabelType(int seriesTooltipLabelType) Specifies the type of information about series that this graph displays in tooltips. |
void |
setTimeAxisData(int type) Specifies if the data provided to Graph is time axis data. |
void |
setTokenSubstitution(TokenSubstitution token) Specifies a handler for token substitution in this view. |
Methods inherited from class oracle.dss.dataView.UIDataviewAdapter |
addControllerListener, applyToDataview, convertComponentTypeToInteger, convertComponentTypeToString, getDataviewFootnote, getDataviewSubtitle, getDataviewTitle, getLocale, getModel, getSelectedObject, getTokenSubstitution, getZoomFactor, initFromDataview, removeControllerListener, selectObject |
Methods inherited from class oracle.dss.util.PagingControlAttributesAdapter |
applyToPagingControlAttributes, initFromPagingControlAttributes |
Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface oracle.dss.dataView.UIDataview |
addControllerListener, getDataviewFootnote, getDataviewSubtitle, getDataviewTitle, getLocale, getSelectedObject, getTokenSubstitution, removeControllerListener |
Methods inherited from interface oracle.dss.dataView.GraphAttribute |
getUISeriesColor |
Methods inherited from interface oracle.dss.dataView.DataviewCommon |
getErrorHandler, getHTMLPagingControlWidth, isHTMLPagingControlAutosubmit, setHTMLPagingControlAutosubmit, setHTMLPagingControlWidth |
Field Detail |
public static final int UNKNOWN
public static final int TIME_AXIS
public static final int NO_TIME_AXIS
Constructor Detail |
public UIGraphAdapter()
public UIGraphAdapter(Graph graph)
Method Detail |
public void setLocale(java.util.Locale loc)
Locale
that this UIGraphAdapter
uses.setLocale
in class UIDataviewAdapter
loc
- The Locale
for this UIGraphAdapter
.public DataSource getDataSource()
getDataSource
in class UIDataviewAdapter
DataSource
for this view. If no model or data source has been set for this view, this method returns null
.public void setDataSource(DataSource dataSource)
DataSource
that will feed data to this graph. If you do not use the Graph(DataSource)
method to create the graph, then you must call this method to specify the data that appears in the graph. To prevent memory leak, the application should call setDataSource(null) on this object after done using this object.setDataSource
in class UIDataviewAdapter
ds
- The DataSource
for this graph to use.public int getDataDirectorType()
DataDirector
, either a cube data director, for multidimensional data, or a relational data director, for relational data.DataDirector
public void setDataDirectorType(int type)
DataDirector
, either a cube data director, for multidimensional data, or a relational data director, for relational data.type
- A constant that represents the type of data director. Constants begin with DDT_.DataDirector
public void applyToGraph(Graph graph)
public void initFromGraph(Graph graph)
public void setDataRowShownAsASeries(boolean yesNo)
UIGraph
DataSource
is translated to PFJ. For example, in a pie graph, series labels appear in the graph legend, and group labels appear under each pie. When data rows are shown as PFJ series, the labels for the data rows appear in the graph legend. When data rows are not shown as PFJ series, but rather as PFJ groups, the row labels appear under each pie, and the column labels appear in the graph legend.setDataRowShownAsASeries
in interface UIGraph
oracle.dss.graph.UIGraph
yesNo
- true
to have data rows shown as PFJ series (and data columns shown as groups), false
to have data rows shown as PFJ groups (and data columns shown as series).public boolean isDataRowShownAsASeries()
DataSource
is translated to PFJ. For example, in a pie graph, series labels appear in the graph legend, and group labels appear under each pie. When data rows are shown as PFJ series, the labels for the data rows appear in the graph legend. When data rows are not shown as PFJ series, but rather as PFJ groups, the row labels appear under each pie, and the column labels appear in the graph legend.isDataRowShownAsASeries
in interface UIGraph
true
if data rows are shown as series, false
if data rows are shown as groups.public int getColumnCount() throws EdgeOutOfRangeException
getColumnCount
in interface UIGraph
EdgeOutOfRangeException
- If the data source does not support the the column edge.isDataRowShownAsASeries()
public int getRowCount() throws EdgeOutOfRangeException
getRowCount
in interface UIGraph
EdgeOutOfRangeException
- If the data source does not support the row edge.isDataRowShownAsASeries()
public java.lang.Object getDataAccessSliceLabel(int edge, int slice, java.lang.String type) throws EdgeOutOfRangeException, SliceOutOfRangeException
DataAccess
for this graph. The UI calls this method to get information about the series when it displays the plot area panel.getDataAccessSliceLabel
in interface UIGraph
edge
- The edge that you want labels for. Series.java calls this with DataAccess.ROW_EDGE
.slice
- The slice of data that you want labels for.type
- The type of data that you want from the DataAccess
. Series.java
calls this method with MetadataMap.METADATA_LONGLABEL
as the type
.EdgeOutOfRangeException
- If edge
is not a valid edge.SliceOutOfRangeException
- If slice
is not a valid slice.DataAccess.getSliceLabel(int, int, java.lang.String)
public void setGraphType(int graphType)
Graph
class and begin with the following:
A point graph, as exposed in the default UI, is a line graph in which isLineDataLineDisplayed
returns false
. A combination graph is a bar graph in which getMarkerType
for one or more series returns anything other than MT_DEFAULT
.
setGraphType
in interface UIGraph
graphType
- A constant that represents the graph type for this graph.isLineDataLineDisplayed()
, Series.getMarkerType(int)
, GraphTypeConverterAdapter
public int getGraphType()
A point graph, as exposed in the default UI, is a line graph in which getLineDataLineDisplayed
returns false
. A combination graph is a bar graph in which getMarkerType
for one or more series returns anything other than MT_DEFAULT
.
getGraphType
in interface UIGraph
isLineDataLineDisplayed()
, Series.getMarkerType(int)
, GraphTypeConverterAdapter
public void setSeriesTooltipLabelType(int seriesTooltipLabelType)
Graph
class and start with TLT_. The default value for SeriesTooltipLabelType
is Graph.TLT_MEMBER
.
In order for the series labels to be displayed, the Graph.MarkerTooltipType
property must be set to include text.
setSeriesTooltipLabelType
in interface UIGraph
seriesTooltipLabelType
- A constant that represents the type of information that the graph should display for series.Graph.TLT_MEMBER
, Graph.TLT_DIM_MEMBER
, Graph.TLT_NONE
, Graph.setMarkerTooltipType(int)
public int getSeriesTooltipLabelType()
Graph
class and start with TLT_. The default value for SeriesTooltipLabelType
is Graph.TLT_MEMBER
.
In order for the series labels to be displayed, the MarkerTooltipType
property must be set to include text.
getSeriesTooltipLabelType
in interface UIGraph
Graph.TLT_MEMBER
, Graph.TLT_DIM_MEMBER
, Graph.TLT_NONE
, Graph.setMarkerTooltipType(int)
public void setGroupTooltipLabelType(int groupTooltipLabelType)
Graph
and start with TLT_. The default value for GroupTooltipLabelType
is Graph.TLT_MEMBER
.setGroupTooltipLabelType
in interface UIGraph
groupTooltipLabelType
- A constant that represents the type of information that the graph should display for groups.Graph.TLT_MEMBER
, Graph.TLT_DIM_MEMBER
, Graph.TLT_NONE
, Graph.setMarkerTooltipType(int)
public int getGroupTooltipLabelType()
Graph
class and start with TLT_. The default value for GroupTooltipLabelType
is Graph.TLT_MEMBER
.getGroupTooltipLabelType
in interface UIGraph
Graph.TLT_MEMBER
, Graph.TLT_DIM_MEMBER
, Graph.TLT_NONE
, Graph.setMarkerTooltipType(int)
public void setMarkerTooltipType(int markerTooltipType)
Graph
class and start with MTT_.
The default value for MarkerTooltipType
is Graph.MTT_VALUES
.
If you set MarkerTooltipType
to include Graph.MTT_TEXT
, then the content of the text is specified by the setSeriesTooltipLabelType
and setGroupTooltipLabelType
methods.
setMarkerTooltipType
in interface UIGraph
marketTooltipType
- A constant that represents the type of information that the graph should display for markers. Except for MTT_NONE
, the constants can be combined by using a bitwise OR (|).setGroupTooltipLabelType(int)
, setSeriesTooltipLabelType(int)
, Graph.MTT_TEXT
, Graph.MTT_VALUES
, Graph.MTT_NONE
, Graph.MTT_PERCENT_VAL
, Graph.MTT_CUM_VAL
public int getMarkerTooltipType()
Graph
class and start with MTT_.
The default value for MarkerTooltipType
is Graph.MTT_VALUES
.
If MarkerTooltipType
includes Graph.MTT_TEXT
, then the content of the text is specified in the SeriesTooltipLabelType
and GroupTooltipLabelType
properties.
getMarkerTooltipType
in interface UIGraph
getGroupTooltipLabelType()
, getSeriesTooltipLabelType()
, Graph.MTT_TEXT
, Graph.MTT_VALUES
, Graph.MTT_NONE
, Graph.MTT_PERCENT_VAL
, Graph.MTT_CUM_VAL
public int getAutoLayout()
getAutoLayout
in interface UIGraph
Graph.AL_ALWAYS
, Graph.AL_AS_NEEDED
, Graph.AL_NEVER
public void setLineDataLineDisplayed(boolean bValue)
false
to this method.setLineDataLineDisplayed
in interface UIGraph
bValue
- true
for a line graph, false
to create a point graph.GraphTypeConverterAdapter
public boolean isLineDataLineDisplayed()
false
.isLineDataLineDisplayed
in interface UIGraph
true
if a line graph displays lines, false
if the line graph does not display lines (presents itself as a point graph).GraphTypeConverterAdapter
public void setTokenSubstitution(TokenSubstitution token)
TokenSubstitution
. You need to call this method only if you provide your own handler for allowing users to insert tokens.setTokenSubstitution
in interface UIDataview
setTokenSubstitution
in class UIDataviewAdapter
token
- The token substitution handler for this view.public GraphTypeConverter getGraphTypeConverter()
GraphTypeConverter
that this graph uses. The GraphTypeConverter
translates the base graph types for a user interface (UI). For example, the default UI for this graph exposes a point graph type. To Perspective for Java, this is really a line graph without the lines. The GraphTypeConverter
maintains the information about the UI version of the graph and the Perspective for Java version.getGraphTypeConverter
in interface UIGraph
GraphTypeConverter
that this graph uses.public void setGraphTypeConverter(GraphTypeConverter graphTypeConverter)
GraphTypeConverter
for the graph type to use. The GraphTypeConverter
translates the base graph types for a user interface (UI). For example, the default UI for this graph exposes a point graph type. To Perspective for Java, this is really a line graph without the lines. The GraphTypeConverter
maintains the information about the UI version of the graph and the Perspective for Java version.
The default UI for the graph sets a default GraphTypeConverter
. You do not have to call this method unless you provide your own UI and your UI exposes graph types that do not correspond directly to the graph type constants in this class.
setGraphTypeConverter
in interface UIGraph
graphTypeConverter
- The GraphTypeConverter
for this graph to use.public boolean isHorizontal()
O1Axis
and its tick labels are vertical. Otherwise, they are horizontal. The plot area panel in the default UI calls this method in order to translate "horizontal" and "vertical" for the end user.isHorizontal
in interface UIGraph
true
if the graph is horizontal, false
if it is vertical.public boolean isO1AxisSupported()
X1Axis
, which shows a scale of data values. Also, graphs such as a pie graph or a ring graph do not have ordinal axes.true
if the current graph type has an ordinal axis, false
if not.public boolean isPagingControlVisible()
isPagingControlVisible
in interface UIGraph
isPagingControlVisible
in class PagingControlAttributesAdapter
true
if the paging control appears with the graph, false
if it does not.PagingControl
public void setPagingControlVisible(boolean bValue)
setPagingControlVisible
in interface UIGraph
setPagingControlVisible
in class PagingControlAttributesAdapter
bValue
- true
to display the paging control, false
to hide it.PagingControl
public void beginAxisChanges()
ValueAxis
class calls this method before it applies the settings of axis scaling options.beginAxisChanges
in interface UIGraph
ValueAxis
public void endAxisChanges()
ValueAxis
class calls this method after it applies the settings of axis scaling options.endAxisChanges
in interface UIGraph
ValueAxis
public void setSeriesObjectCount(int count)
count
- The number of series that this graph should store properties for before it repeats properties. Valid values are 1 - Graph.SERIESOBJECTCOUNTLIMIT
.Series
public int getSeriesObjectCount()
getSeriesObjectCount
in interface UIGraph
Series
public boolean isGroupSeriesTooltipSupported(int edge)
Application developers should not need to call this method.
isGroupSeriesTooltipSupported
in interface UIGraph
edge
- DataDirector.ROW_EDGE
for the row edge, or DataDirector.COLUMN_EDGE
for the column edge.true
If the the option is supported false
If the option is not supported and the checkbox should be disabled.DataDirector.COLUMN_EDGE
, DataDirector.ROW_EDGE
public DataFilter getDataFilter()
DataFilter
interface.getDataFilter
in interface UIGraph
DataFilter
interface.public ViewStyle getComponentViewStyle(ComponentHandle componentHandle)
GraphAttribute
ViewStyle
for a selected component. The graph supports a ViewStyle
for page items only.getComponentViewStyle
in interface GraphAttribute
oracle.dss.dataView.GraphAttribute
componentHandle
- The ComponentHandle
for the component whose ViewStyle
you want. Implementers should screen for the PageItemComponentHandle
.ViewStyle
for page items.PageItemComponentHandle
public void applyViewStyle(ComponentHandle componentHandle, ViewStyle viewStyle)
GraphAttribute
ViewStyle
to a page item.applyViewStyle
in interface GraphAttribute
oracle.dss.dataView.GraphAttribute
componentHandle
- The ComponentHandle
for the page item that you want to format.viewStyle
- The ViewStyle
that specifies formatting for the page item.public int getViewType()
getViewType
in interface UIDataview
getViewType
in class UIDataviewAdapter
Dataview.VIEW_TYPE_GRAPH
public UIParetoLine getParetoLine()
getParetoLine
in interface UIGraph
public getUIX1ReferenceLine()
UIReferenceLine
interface that represents the X1ReferenceLine
component of a graph.getUIX1ReferenceLine
in interface UIGraph
UIReferenceLine
interface that represents the X1ReferenceLine
.public getUIY1ReferenceLine()
UIReferenceLine
interface that represents the Y1ReferenceLine
component of a graph.getUIY1ReferenceLine
in interface UIGraph
UIReferenceLine
interface that represents the Y1ReferenceLine
.public getUIY2ReferenceLine()
UIReferenceLine
interface that represents the Y2ReferenceLine
component of a graph.getUIY2ReferenceLine
in interface UIGraph
UIReferenceLine
interface that represents the Y2ReferenceLine
.public boolean isMarkerDisplayed()
isMarkerDisplayed
in interface UIGraph
true
if the line graph displays data markers, false
if it does not.DataMarker
public void setMarkerDisplayed(boolean yesNo)
setMarkerDisplayed
in interface UIGraph
yesNo
- true
to display data markers, false
to hide data markers.DataMarker
public void setTimeAxisData(int type)
public int getTimeAxisData()
public void cleanUp()
|
Oracle™ Business Intelligence Beans Java API Reference | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |