quadbase.util

Interface IPlot

All Superinterfaces:

IGradientPropertySet, IGradientSupport

All Known Subinterfaces:

IAnnotation, ILegend

public interface IPlot
extends IGradientPropertySet

This interface defines methods to modify properties associated with the plot area for the main chart as well as the legend.

A handle to an object that implements this interface can be obtained in two ways:

1. By calling the gethChartPlot method in QbChart. This returns a handle to the plot area containing the main chart.

2. By obtaining a handle to the ILegend interface, which extends IPlot.

See Also:

ILegend

Method Summary

Modifier and Type	Method and Description
int	getAppearance() Returns the background appearance for the chart/legend plot area.
java.awt.Color	getBackgroundColor() Returns the color of the chart/legend plot area background.
java.awt.Color	getBorderColor() Returns the color of the chart/legend plot area border.
int	getBorderThickness() Returns the border thickness for the chart plot area.
int	getCutCornerWidth() Gets the cut corner width for the cut corner appearance (in pixel)
int	getDepth() Returns the data plotting area depth.
java.lang.String	getDialBGImageRelativeURL() Gets the relative URL of the dial chart plot background image
java.net.URL	getDialBGImageURL() Gets the full URL of the dial chart plot background image
double	getDialBGRatio() Gets the radius ratio of the dial chart plot background image to the plot area
boolean	getDialBGState() Gets the state of dial chart plot background image
java.lang.String	getDialFGImageRelativeURL() Gets the relative URL of the dial chart plot foreground image
java.net.URL	getDialFGImageURL() Gets the full URL of the dial chart plot foreground image
double	getDialFGRatio() Gets the radius ratio of the dial chart plot foreground image to the plot area
boolean	getDialFGState() Gets the state of dial chart plot foreground image
Position	getPosition() Gets the x,y position of the chart/legend plot area relative to the main chart canvas.
float	getRelativeHeight() Returns the height of the plot area relative to the main chart canvas.
float	getRelativeWidth() Returns the width of the plot area relative to the main chart canvas.
boolean	isBackgroundVisible() Returns whether or not the background for the chart/legend plot area is visible.
boolean	isBorderVisible() Returns whether or not a border is drawn around the chart/legend plot area.
void	setAppearance(int x) Sets the background appearance for the chart/legend plot area.
void	setBackgroundColor(java.awt.Color c) Sets the color of the chart/legend plot area background.
void	setBackgroundVisible(boolean b) Enables/Disables drawing of a background for the chart/legend plot area.
void	setBorderColor(java.awt.Color c) Sets the border color for the chart/legend plot area.
void	setBorderThickness(int x) Sets the border thickness for the chart plot area.
void	setBorderVisible(boolean b) Enable/Disable drawing of the border for chart/legend plot area.
void	setCutCornerWidth(int cutCorner) Gets the cut corner width for the cut corner appearance
void	setDepth(int x) Sets the data plotting area depth.
void	setDialBGImage(java.net.URL url, int option) Sets the dial chart plot background image
void	setDialBGImage(java.net.URL url, java.lang.String relativeURL, int option) Sets the dial chart plot background image including relative URL.
void	setDialBGRatio(double ratio) Sets the radius ratio for the dial chart plot background image.
void	setDialBGState(boolean state) Enable or disables the dial chart plot background image.
void	setDialFGImage(java.net.URL url, int option) Sets the dial chart plot foreground image
void	setDialFGImage(java.net.URL url, java.lang.String relativeURL, int option) Sets the dial chart plot foreground image including relative URL.
void	setDialFGRatio(double ratio) Sets the radius ratio for the dial chart plot foreground image.
void	setDialFGState(boolean state) Enable or disables the dial chart plot foreground image.
void	setPosition(Position p) Sets the x,y positon of the chart/legend plot area relative to the main chart window.
void	setRelativeHeight(float height) Sets the height of the plot area relative to the main chart canvas.
void	setRelativeWidth(float width) Sets the width of the plot area relative to the main chart canvas.

Methods inherited from interface quadbase.util.IGradientPropertySet

set3DShadingEnabled, setGradientCyclic, setGradientDesColor, setGradientEnabled, setGradientEndX, setGradientEndY, setGradientShade, setGradientStartX, setGradientStartY

Methods inherited from interface quadbase.util.IGradientSupport

getGradientDesColor, getGradientEndX, getGradientEndY, getGradientShade, getGradientStartX, getGradientStartY, is3DShadingEnabled, isGradientCyclic, isGradientEnabled

Method Detail

getRelativeWidth

float getRelativeWidth()

Returns the width of the plot area relative to the main chart canvas.

Associated QbChart property: PLOT_WIDTH

Returns:

The relative width of the plot area ( 0 - 1)

setRelativeWidth

void setRelativeWidth(float width)

Sets the width of the plot area relative to the main chart canvas.

Parameters:

width - The relative width of the chart plot area. Should be between 0 and 1.

getRelativeHeight

float getRelativeHeight()

Returns the height of the plot area relative to the main chart canvas.

Associated QbChart property: PLOT_HEIGHT

Returns:

The relative height of the plot area (0 - 1)

setRelativeHeight

void setRelativeHeight(float height)

Sets the height of the plot area relative to the main chart canvas.

Parameters:

height - The relative height of the chart plot area. Should be between 0 and 1.

getPosition

Position getPosition()

Gets the x,y position of the chart/legend plot area relative to the main chart canvas.

Associated QbChart property:

 
   PLOT_XPOS
   PLOT_YPOS
   LEGEND_XPOS
   LEGEND_YPOS
 
 

Returns:

A Position object containing the relative x,y position of the plot area. The x and y values in the Position object are between 0 and 1.

See Also:

Position

setPosition

void setPosition(Position p)

Sets the x,y positon of the chart/legend plot area relative to the main chart window.

Parameters:

p - The Position object containing the relative positon.

See Also:

Position

isBorderVisible

boolean isBorderVisible()

Returns whether or not a border is drawn around the chart/legend plot area.

Associated QbChart property:

 
   DRAW_PLOTBORDER
   LEGEND_DRAWBORDER
 
 

Returns:

True if the plot area border is visible, false otherwise.

setBorderVisible

void setBorderVisible(boolean b)

Enable/Disable drawing of the border for chart/legend plot area.

Parameters:

b - The border drawing status.

getBorderColor

java.awt.Color getBorderColor()

Returns the color of the chart/legend plot area border.

Associated QbChart property:

 
   PLOT_BORDERCOLOR
   LEGEND_BORDERCOLOR
 
 

Returns:

The Color object containing the border color.

See Also:

isBorderVisible()

setBorderColor

void setBorderColor(java.awt.Color c)

Sets the border color for the chart/legend plot area.

Parameters:

c - The Color object containing the border color.

getBorderThickness

int getBorderThickness()

Returns the border thickness for the chart plot area.

Associated QbChart property: PLOT_BORDER_THICKNESS

Returns:

The border thickness value.

setBorderThickness

void setBorderThickness(int x)

Sets the border thickness for the chart plot area.

Parameters:

x - The border thickness value.

isBackgroundVisible

boolean isBackgroundVisible()

Returns whether or not the background for the chart/legend plot area is visible.

Associated QbChart property:

 
   DRAW_PLOTBACKGROUND
   LEGEND_DRAWBACKGROUND
 
 

Returns:

The display status of the plot area background for 2D charts.

setBackgroundVisible

void setBackgroundVisible(boolean b)

Enables/Disables drawing of a background for the chart/legend plot area.

Parameters:

b - The display status for the background.

getBackgroundColor

java.awt.Color getBackgroundColor()

Returns the color of the chart/legend plot area background.

Associated QbChart property:

 
   PLOT_BACKGROUNDCOLOR
   LEGEND_BACKGROUNDCOLOR
 
 

Returns:

The color of the plot area background.

See Also:

isBackgroundVisible()

setBackgroundColor

void setBackgroundColor(java.awt.Color c)

Sets the color of the chart/legend plot area background.

Parameters:

c - The color value.

getAppearance

int getAppearance()

Returns the background appearance for the chart/legend plot area.

Associated QbChart property:

 
   PLOT_BACKGROUND_APPEARANCE
   LEGEND_APPEARANCE
 
 

Returns:

the background appearance. Valid values are:

   QbChart.RAISE
   QbChart.LOWER
   QbChart.PLAIN
   QbChart.SHADOW
   QbChart.NONE
 

setAppearance

void setAppearance(int x)

Sets the background appearance for the chart/legend plot area.

Parameters:

x - The background appearance.

See Also:

getAppearance()

getDepth

int getDepth()

Returns the data plotting area depth.

Associated QbChart property:

 
   PLOT_BACKGROUND_DEPTH
   LEGEND_DEPTH
 
 

Returns:

The data plotting area depth

setDepth

void setDepth(int x)

Sets the data plotting area depth.

Parameters:

x - The data plotting area depth value.

See Also:

getDepth()

setDialBGState

void setDialBGState(boolean state)

Enable or disables the dial chart plot background image.

Parameters:

state -

setDialBGImage

void setDialBGImage(java.net.URL url,
                    java.lang.String relativeURL,
                    int option)

Sets the dial chart plot background image including relative URL.

Parameters:

url - Full URL of image

relativeURL - Relative URL of image

option - Image option, see ImageData class

setDialBGRatio

void setDialBGRatio(double ratio)

Sets the radius ratio for the dial chart plot background image.

Parameters:

ratio -

setDialBGImage

void setDialBGImage(java.net.URL url,
                    int option)

Sets the dial chart plot background image

Parameters:

url - Full URL of image

option - Image option, see ImageData class

getDialBGState

boolean getDialBGState()

Gets the state of dial chart plot background image

Returns:

Returns whether dial chart plot background image is enabled or disabled

getDialBGImageURL

java.net.URL getDialBGImageURL()

Gets the full URL of the dial chart plot background image

Returns:

The full URL of the dial chart plot background image

getDialBGImageRelativeURL

java.lang.String getDialBGImageRelativeURL()

Gets the relative URL of the dial chart plot background image

Returns:

The relative URL of the dial chart plot background image

getDialBGRatio

double getDialBGRatio()

Gets the radius ratio of the dial chart plot background image to the plot area

Returns:

the radius ratio

setDialFGState

void setDialFGState(boolean state)

Enable or disables the dial chart plot foreground image.

Parameters:

state -

setDialFGImage

void setDialFGImage(java.net.URL url,
                    java.lang.String relativeURL,
                    int option)

Sets the dial chart plot foreground image including relative URL.

Parameters:

url - Full URL of image

relativeURL - Relative URL of image

option - Image option, see ImageData class

setDialFGRatio

void setDialFGRatio(double ratio)

Sets the radius ratio for the dial chart plot foreground image.

Parameters:

ratio -

setDialFGImage

void setDialFGImage(java.net.URL url,
                    int option)

Sets the dial chart plot foreground image

Parameters:

url - Full URL of image

option - Image option, see ImageData class

getDialFGState

boolean getDialFGState()

Gets the state of dial chart plot foreground image

Returns:

Returns whether dial chart plot foreground image is enabled or disabled

getDialFGImageURL

java.net.URL getDialFGImageURL()

Gets the full URL of the dial chart plot foreground image

Returns:

The full URL of the dial chart plot foreground image

getDialFGImageRelativeURL

java.lang.String getDialFGImageRelativeURL()

Gets the relative URL of the dial chart plot foreground image

Returns:

The relative URL of the dial chart plot foreground image

getDialFGRatio

double getDialFGRatio()

Gets the radius ratio of the dial chart plot foreground image to the plot area

Returns:

the radius ratio

setCutCornerWidth

void setCutCornerWidth(int cutCorner)

Gets the cut corner width for the cut corner appearance

getCutCornerWidth

int getCutCornerWidth()

Gets the cut corner width for the cut corner appearance (in pixel)