oracle.dss.graph
Class Annotation

java.lang.Object
  oracle.dss.dataView.BaseComponentXML
      oracle.dss.graph.BaseGraphComponent
          oracle.dss.graph.Annotation

All Implemented Interfaces:

VerticalAlignment

public class Annotation
extends BaseGraphComponent
implements VerticalAlignment

This class

Field Summary

protected GraphFont	m_font
protected int	m_group
protected oracle.dss.graph.pfj.draw.IdentObj	m_idBox
protected int	m_series
protected SFX	m_sfx

Fields inherited from class oracle.dss.graph.BaseGraphComponent

a_assignedToY2, a_association, a_automaticRotation, a_axisAutoScaledFromZero, a_axisMaxAutoScaled, a_axisMaxValue, a_axisMinAutoScaled, a_axisMinValue, a_axisZoomMaxValue, a_axisZoomMinValue, a_backGround, a_borderStyle, a_borderTransparent, a_borderUsingDefaults, a_borderWidth, a_color, a_defaultAssignedToY2, a_defaultBorderColor, a_defaultBorderTransparent, a_defaultColor, a_defaultFirstMarkerColor, a_defaultFitlineType, a_defaultHighMarkerColor, a_defaultLastMarkerColor, a_defaultLineWidth, a_defaultLowMarkerColor, a_defaultMarkerColor, a_defaultMarkers, a_defaultMarkerShape, a_defaultMarkerType, a_displayedInLegend, a_effect, a_explicitEnd, a_explicitStart, a_fitlineType, a_focusFactor, a_group, a_height, a_high_value, a_horizontalAlignment, a_imageSource, a_isometricProjection, a_labelPosition, a_legendMarkersPerRow, a_legendOrientation, a_legendTextPosition, a_lightSourceX, a_lightSourceY, a_lightSourceZ, a_line_value, a_lineColor, a_lineIndex, a_lineStyle, a_lineWidth, a_location, a_logarithmicBase, a_low_value, a_majorIncrement, a_majorTickCount, a_majorTickStep, a_majorTickStepAutomatic, a_markerColor, a_markerShape, a_markerSize, a_markersPerRowAutomatic, a_markerTextAngleDefault, a_markerTextPlace, a_markerTextRadiusDefault, a_markerType, a_minorIncrement, a_minorTickCount, a_minorTickStep, a_minorTickStepType, a_mode, a_panX, a_panY, a_pieSliceExplode, a_quadrantLineCountX, a_quadrantLineCountY, a_quadrantLineValueX, a_quadrantLineValueY, a_rendered, a_rollover_behavior, a_scaledLogarithmic, a_series, a_shapePath, a_sharePanelProperties, a_shortDesc, a_sizeX, a_sizeY, a_sizeZ, a_skippedWithLabels, a_squareRisers, a_text, a_textFittingAutomatic, a_textRotation, a_textType, a_thresholdMaxValue, a_thresholdMinValue, a_tickLabelSkipCount, a_tickLabelSkipFirst, a_tickLabelSkipMode, a_tickLabelStaggered, a_tickLabelWrapped, a_tickStyle, a_translationX, a_translationY, a_translationZ, a_transparent, a_type, a_verticalAlignment, a_viewerX, a_viewerY, a_viewerZ, a_visibility, a_visible, a_wallThickX, a_wallThickY, a_wallThickZ, a_width, a_wordWrapEnabled, a_x, a_xValue, a_y, a_yValue, a_yValueAssignment, a_zoomFactor, al_both, AL_BOTH, al_left, AL_LEFT, al_right, AL_RIGHT, ap_always, AP_ALWAYS, ap_never, AP_NEVER, ar_horiz_rotate_270, AR_HORIZ_ROTATE_270, ar_horiz_rotate_90, AR_HORIZ_ROTATE_90, ar_no_rotate, AR_NO_ROTATE, CONV_MAP, dy2_auto_assign, DY2_AUTO_ASSIGN, dy2_false, DY2_FALSE, dy2_true, DY2_TRUE, FP_LG_CHECK, FP_LG_CROSSHATCH, FP_LG_DIAG_UP_LT, FP_LG_DIAG_UP_RT, FP_LG_DIAMOND_CHECK, FP_LG_TRIANGLE_CHECK, FP_MAX, FP_SM_CHECK, FP_SM_CROSSHATCH, FP_SM_DIAG_UP_LT, FP_SM_DIAG_UP_RT, FP_SM_DIAMOND_CHECK, FP_SM_TRIANGLE_CHECK, fs_bold, FS_BOLD, fs_bold_italic_underline, FS_BOLD_ITALIC_UNDERLINE, fs_bold_underline, FS_BOLD_UNDERLINE, fs_italic, FS_ITALIC, fs_italic_bold, FS_ITALIC_BOLD, fs_italic_underline, FS_ITALIC_UNDERLINE, fs_plain, FS_PLAIN, fs_underline, FS_UNDERLINE, ft_color, FT_COLOR, ft_exponential, FT_EXPONENTIAL, ft_gradient, FT_GRADIENT, ft_linear, FT_LINEAR, ft_logarithmic, FT_LOGARITHMIC, ft_none, FT_NONE, FT_PATTERN, ft_texture, FT_TEXTURE, gd_diagonal_135, GD_DIAGONAL_135, gd_diagonal_45, GD_DIAGONAL_45, gd_down, GD_DOWN, gd_down_left, GD_DOWN_LEFT, gd_down_right, GD_DOWN_RIGHT, gd_left, GD_LEFT, gd_radial, GD_RADIAL, gd_radial_bottom_left, GD_RADIAL_BOTTOM_LEFT, gd_radial_bottom_right, GD_RADIAL_BOTTOM_RIGHT, gd_radial_top_left, GD_RADIAL_TOP_LEFT, gd_radial_top_right, GD_RADIAL_TOP_RIGHT, gd_right, GD_RIGHT, gd_up, GD_UP, gd_up_left, GD_UP_LEFT, gd_up_right, GD_UP_RIGHT, gs_automatic, GS_AUTOMATIC, gs_extended, GS_EXTENDED, gs_grid, GS_GRID, gs_in, GS_IN, gs_none, GS_NONE, gs_out, GS_OUT, gs_span, GS_SPAN, lap_bottom, LAP_BOTTOM, lap_left, LAP_LEFT, lap_right, LAP_RIGHT, lap_top, LAP_TOP, ld_percent, LD_PERCENT, ld_text, LD_TEXT, ld_text_percent, LD_TEXT_PERCENT, ld_text_value, LD_TEXT_VALUE, ld_value, LD_VALUE, LEGENDMARKERSLIMIT, lo_automatic, LO_AUTOMATIC, lo_horizontal, LO_HORIZONTAL, lo_vertical, LO_VERTICAL, lp_inside, LP_INSIDE, lp_no_labels, LP_NO_LABELS, lp_outside_feeler_if_needed, LP_OUTSIDE_FEELER_IF_NEEDED, lp_outside_with_feeler, LP_OUTSIDE_WITH_FEELER, lp_outside_without_feeler, LP_OUTSIDE_WITHOUT_FEELER, ls_dash, LS_DASH, ls_dash_dot, LS_DASH_DOT, ls_dotted, LS_DOTTED, ls_solid, LS_SOLID, ltp_above, LTP_ABOVE, ltp_below, LTP_BELOW, ltp_on_left, LTP_ON_LEFT, ltp_on_marker, LTP_ON_MARKER, ltp_on_right, LTP_ON_RIGHT, m_commonGraph, m_identObj, m_pfj, ms_automatic, MS_AUTOMATIC, ms_circle, MS_CIRCLE, ms_diamond, MS_DIAMOND, ms_human, MS_HUMAN, ms_none, MS_NONE, ms_plus, MS_PLUS, ms_square, MS_SQUARE, ms_triangle_down, MS_TRIANGLE_DOWN, ms_triangle_up, MS_TRIANGLE_UP, mt_area, MT_AREA, mt_bar, MT_BAR, mt_centered_stepped_line, MT_CENTERED_STEPPED_LINE, MT_CURVE_AREA, mt_curve_line, MT_CURVE_LINE, mt_default, MT_DEFAULT, mt_line, MT_LINE, mt_marker, MT_MARKER, mt_stepped_line, MT_STEPPED_LINE, mtp_center, MTP_CENTER, mtp_custom, MTP_CUSTOM, mtp_inside_max, MTP_INSIDE_MAX, mtp_inside_min, MTP_INSIDE_MIN, mtp_on_maxedge, MTP_ON_MAXEDGE, mtp_outside_max, MTP_OUTSIDE_MAX, mtp_under_marker, MTP_UNDER_MARKER, QUADRANTLINEVALUELIMIT, REV_CONV_MAP, ro_area, RO_AREA, ro_back, RO_BACK, ro_front, RO_FRONT, ro_line, RO_LINE, SHAPE_AUTOMATIC, SHAPE_CIRCLE, SHAPE_DIAMOND, SHAPE_HUMAN, SHAPE_NONE, SHAPE_PLUS, SHAPE_SQUARE, SHAPE_TRIANGLE_DOWN, SHAPE_TRIANGLE_UP, sv_hidden, SV_HIDDEN, sv_visible, SV_VISIBLE, tdm_stretched, TDM_STRETCHED, tdm_tiled, TDM_TILED, tls_automatic, TLS_AUTOMATIC, tls_manual, TLS_MANUAL, tls_noskip, TLS_NOSKIP, tr_horiz, TR_HORIZ, tr_horiz_rotate_270, TR_HORIZ_ROTATE_270, tr_horiz_rotate_90, TR_HORIZ_ROTATE_90, tsm_explicit, TSM_EXPLICIT, tsm_off, TSM_OFF, va_bottom, va_center, va_top, VF_PIE_SLICE_LABEL, VF_STOCK_VOLUME, VF_X1, VF_Y1, VF_Y2, VF_Z

Fields inherited from class oracle.dss.dataView.BaseComponentXML

m_jsfHashMap

Constructor Summary

Annotation(CommonGraph graph, int series, int group)

Method Summary

java.awt.Color	getBorderColor() Retrieves the border color of this annotation.
protected java.lang.String	getComponentName()
java.awt.Color	getFillColor() Retrieves the background color of the annotation.
java.awt.Font	getFont() Retrieves a Font object for the text of the annotation.
GraphFont	getGraphFont() Retrieves a GraphFont object for the text of the annotation.
int	getHorizontalAlignment() Retrieves the horizontal alignment of this annotation.
int	getID() Retrieves the ID of this ReferenceObject.
GraphConstants.AnnotationLocation	getLocation() Returns the location of this annotation.
GraphConstants.AnnotationPosition	getPosition() Returns the position of this annotation. When the position is set to GraphConstants.AnnotationPosition.ABSOLUTE or GraphConstants.AnnotationPosition.PERCENTAGE, the annotation is positioned at exactly the xy location specified, without taking into account overlap or clipping.
SFX	getSFX() Retrieves the SFX object for this exceptional riser.
java.lang.String	getText() Retrieves the text for the annotation.
int	getVerticalAlignment() Retrieves the vertical alignment of this annotation.
protected oracle.dss.util.xml.ObjectNode	getXML(boolean allProperties, boolean allOverriddenProperties)
double	getXValue() Returns the x value of the annotation.
double	getYValue() Returns the y value of the annotation.
boolean	isVisible() Indicates whether the annotation is visible.
boolean	selectObject(int series, int group) Selects the annotation on the graph.
void	setBorderColor(java.awt.Color newColor) Specifies the border color of this annotation.
void	setFillColor(java.awt.Color newColor) Specifies the background color of the annotation.
void	setFont(java.awt.Font f) Specifies a Font object for the text of the annotation.
void	setHorizontalAlignment(int a) Specifies the horizontal alignment of this annotation.
void	setLocation(GraphConstants.AnnotationLocation location) Specifies the location of this annotation.
void	setPosition(GraphConstants.AnnotationPosition pos) Specifies the position of this annotation. When the position is set to GraphConstants.AnnotationPosition.ABSOLUTE or GraphConstants.AnnotationPosition.PERCENTAGE, the annotation is positioned at exactly the xy location specified, without taking into account overlap or clipping.
void	setText(java.lang.String str) Specifies the text of the annotation.
void	setVerticalAlignment(int a) Specifies the vertical alignment of this annotation.
void	setVisible(boolean yesNo) Specifies whether the annotation is visible.
void	setXML(oracle.dss.util.xml.ObjectNode node)
void	setXML(oracle.dss.util.xml.ObjectNode node, java.util.HashMap map)
void	setXValue(double value) Set the x value of the annotation.
void	setYValue(double value) Set the y value of the annotation.

Methods inherited from class oracle.dss.graph.BaseGraphComponent

convertAssociationToInt, convertFillPatternToString, convertGradientDirectionToString, convertHorizontalAlignmentToInt, convertHorizontalAlignmentToString, convertLineStyleToInt, convertLineStyleToString, convertLocationToInt, convertTextRotationtToInt, convertTickStyleToInt, convertTypeToInt, convertVerticalAlignmentToInt, convertVerticalAlignmentToString, hexStringToInt, toHexString

Methods inherited from class oracle.dss.dataView.BaseComponentXML

getNonstyleXML, getStyleXML, getStyleXML, getXML, setNonstyleXML, setNonstyleXML, setStyleXML, setXML, setXML

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

m_sfx

protected SFX m_sfx

For internal use only. Application developers should not use this

m_font

protected GraphFont m_font

For internal use only. Application developers should not use this

m_idBox

protected oracle.dss.graph.pfj.draw.IdentObj m_idBox

m_series

protected int m_series

m_group

protected int m_group

Constructor Detail

Annotation

public Annotation(CommonGraph graph,
                  int series,
                  int group)

Parameters:

graph - The graph that this object belongs to.

For internal use only. Application developers should not use this

Constructor. Application developers should not have to construct this object, because the graph does it automatically.

Method Detail

selectObject

public boolean selectObject(int series,
                            int group)

Selects the annotation on the graph.

Overrides:

selectObject in class BaseGraphComponent

Parameters:

series - Any integer.

group - Any integer.

Returns:

true if successful, false if not.

setPosition

public void setPosition(GraphConstants.AnnotationPosition pos)

Specifies the position of this annotation.
When the position is set to GraphConstants.AnnotationPosition.ABSOLUTE or GraphConstants.AnnotationPosition.PERCENTAGE, the annotation is positioned at exactly the xy location specified, without taking into account overlap or clipping.

Parameters:

pos - the position to use for this annotation

See Also:

GraphConstants.AnnotationPosition

getPosition

public GraphConstants.AnnotationPosition getPosition()

Returns the position of this annotation.
When the position is set to GraphConstants.AnnotationPosition.ABSOLUTE or GraphConstants.AnnotationPosition.PERCENTAGE, the annotation is positioned at exactly the xy location specified, without taking into account overlap or clipping.

Returns:

the position to use for this annotation

See Also:

GraphConstants.AnnotationPosition

getLocation

public GraphConstants.AnnotationLocation getLocation()

Returns the location of this annotation.

Returns:

the location to use for this annotation

See Also:

GraphConstants.AnnotationLocation

setLocation

public void setLocation(GraphConstants.AnnotationLocation location)

Specifies the location of this annotation.

Parameters:

location - the location to use for this annotation

See Also:

GraphConstants.AnnotationLocation

setXValue

public void setXValue(double value)

Set the x value of the annotation. This setting only applies if the position is absolute or percentage. If position is percentage, this value must be between 0 and 100.

Parameters:

value - the x value of the annotation

getXValue

public double getXValue()

Returns the x value of the annotation. This setting only applies if the position is absolute or percentage. If position is percentage, this value must be between 0 and 100.

Returns:

the x value of the annotation

setYValue

public void setYValue(double value)

Set the y value of the annotation. This setting only applies if the position is absolute or percentage. If position is percentage, this value must be between 0 and 100.

Parameters:

value - the y value of the annotation

getYValue

public double getYValue()

Returns the y value of the annotation. This setting only applies if the position is absolute or percentage. If position is percentage, this value must be between 0 and 100.

Returns:

the y value of the annotation

getBorderColor

public java.awt.Color getBorderColor()

Retrieves the border color of this annotation.

Returns:

The border color of this annotation.

setBorderColor

public void setBorderColor(java.awt.Color newColor)

Specifies the border color of this annotation.

Parameters:

newColor - The border color of this annotation.

getFillColor

public java.awt.Color getFillColor()

Retrieves the background color of the annotation.

Returns:

The background color of the specified annotation.

setFillColor

public void setFillColor(java.awt.Color newColor)

Specifies the background color of the annotation.

Parameters:

newColor - The background color for the annotation. The default is (0xaffaf6f0)

isVisible

public boolean isVisible()

Indicates whether the annotation is visible.

Returns:

true if it is visible, false if it is invisible.

setVisible

public void setVisible(boolean yesNo)

Specifies whether the annotation is visible.

Parameters:

yesNo - true to make it visible, false to make it invisible.

getGraphFont

public GraphFont getGraphFont()

Retrieves a GraphFont object for the text of the annotation. Use the GraphFont objects to specify and retrieve font properties such as name, color, style, and size in virtual coordinates. Virtual coordinates make the font size relative to the size of the graph.

Returns:

A GraphFont object for the object.

setFont

public void setFont(java.awt.Font f)

Specifies a Font object for the text of the annotation. This is the awt object with properties such as name, style, and absolute size.

Parameters:

f - A Font object for this object.

getFont

public java.awt.Font getFont()

Retrieves a Font object for the text of the annotation. This is the awt object with properties such as name, style, and absolute size.

Returns:

A Font object for the object.

getText

public java.lang.String getText()

Retrieves the text for the annotation. This text will appear as a Legend text for this annotation.

Returns:

The text for the annotation.

setText

public void setText(java.lang.String str)

Specifies the text of the annotation. This text will appear as a Legend text for this annotation.

Parameters:

str - The text of the annotation.

getHorizontalAlignment

public int getHorizontalAlignment()

Retrieves the horizontal alignment of this annotation. This only applies when the position of the annotation is not GraphConstants.AnnotationPosition.DATA_VALUE. The constants are SwingConstants.LEFT, SwingConstants.CENTER, and SwingConstants.RIGHT.

Returns:

A swing constant that represents the horozontal alignment of this annotation

setHorizontalAlignment

public void setHorizontalAlignment(int a)

Specifies the horizontal alignment of this annotation. This only applies when the position of the annotation is not GraphConstants.AnnotationPosition.DATA_VALUE.

Parameters:

a - A Swing constant that represents the horizontal alignment for the text of the title. Valid constants are SwingConstants.LEFT, SwingConstants.CENTER, and SwingConstants.RIGHT.

getVerticalAlignment

public int getVerticalAlignment()

Retrieves the vertical alignment of this annotation. This only applies when the position of the annotation is not GraphConstants.AnnotationPosition.DATA_VALUE. The swing constants are SwingConstants.TOP, SwingConstants.CENTER, and SwingConstants.BOTTOM.

Specified by:

getVerticalAlignment in interface VerticalAlignment

Returns:

A swing constant that represents the vertical alignment of the annotation.

setVerticalAlignment

public void setVerticalAlignment(int a)

Specifies the vertical alignment of this annotation. This only applies when the position of the annotation is not GraphConstants.AnnotationPosition.DATA_VALUE. The swing constants are SwingConstants.TOP, SwingConstants.CENTER, and SwingConstants.BOTTOM.

Specified by:

setVerticalAlignment in interface VerticalAlignment

Parameters:

a - A swing constant that represents the vertical alignment of the annotation.

getSFX

public SFX getSFX()

Retrieves the SFX object for this exceptional riser. This allows you to retrieve and specify attributes for special effects.

Returns:

The SFX object for this exceptional riser.

getID

public int getID()

Retrieves the ID of this ReferenceObject.

Returns:

ID of this ReferenceObject.

getComponentName

protected java.lang.String getComponentName()

Overrides:

getComponentName in class BaseComponentXML

For internal use only. Application developers should not use this

Retrieves the name of the object.

getXML

protected oracle.dss.util.xml.ObjectNode getXML(boolean allProperties,
                                                boolean allOverriddenProperties)

For internal use only. Application developers should not use this

Retrieves XML from this component returns null if no property is overridden

setXML

public void setXML(oracle.dss.util.xml.ObjectNode node,
                   java.util.HashMap map)

Overrides:

setXML in class BaseComponentXML

For internal use only. Application developers should not use this

Sets XML on this component

setXML

public void setXML(oracle.dss.util.xml.ObjectNode node)

Overrides:

setXML in class BaseComponentXML

For internal use only. Application developers should not use this

Sets properties of this component from XML