Purpose: Base class for all other graphical Statbeans. This bean is not intended to be used directly, but provides general properties for all graphical Statbeans.
Read/Write Properties
Name |
Type |
Description |
Possible Values |
Default Value |
allBlackAndWhite |
boolean |
Whether to draw graphics in only black and white. |
true,false |
false |
axisColor |
Color |
The color of the axes. |
Any valid Color. |
Color.blue |
bottomMargin |
int |
The bottom margin as a percentage of the height of the canvas. |
0-50 |
25 |
Border |
boolean |
Whether a border is drawn around the StatBean's canvas. |
true,false |
true |
crosshairsColor |
Color |
Color used to draw crosshairs. |
Any Color. |
Color.darkGray |
showCrosshairsMessage |
boolean |
Whether to display crosshair coordinates. |
true,false |
false |
drawCrosshairsOnMouseDown |
boolean |
Whether to draw crosshairs when mouse is pressed. |
true,false |
false |
fillColor |
Color |
The color of the first fill. |
Any valid Color. |
Color.blue |
fillColors(int k) |
Color |
The color of fill set k. |
Any valid Color. |
Varied. |
fullFrame |
boolean |
Whether the X-Y axes have four sides rather than two. |
true,false |
true |
gridColor |
Color |
The color of the grid. |
Any valid Color. |
Color.lightGray |
gridDirection |
String |
The type of grid to be added to the plot. |
"None", |
"Bidirectional" |
highlightColor |
Color |
Color used to highlight point. |
Any Color. |
Color.red |
highlightPointOnMouseClick |
boolean |
Whether to highlight point if clicked on by mouse. |
true,false |
false |
interiorColor |
Color |
The color of the area inside the axes. |
Any valid Color. |
Color.yellow |
leftMargin |
int |
The left margin as a percentage of the width of the canvas. |
0-50 |
25 |
legendColor |
Color |
Color used for legend. |
Any Color. |
Color.red |
legendFont |
Font |
The font used for the legend. |
Any Font. |
"Serif",0,10 |
legendHorizontalLocation |
double |
Location of the legend in (0,1) axis coordinates. |
Any double. |
1.05 |
legendText |
String |
The legend text, delimited by \n. |
Any string, or "@" to generate a default legend. |
"@" |
legendTitle |
String |
The title displayed above th legends. |
Any string, or "@" to generate a default title. |
"@" |
legendVerticalLocation |
double |
Location of the legend in (0,1) axis coordinates. |
Any double. |
0.90 |
lineColor |
Color |
The color of the line connecting the points. |
Any valid Color. |
Color.black |
lineColors(int k) |
Color |
The color of line set k. |
Any valid Color. |
Varied. |
messageColor |
Color |
Color used for message. |
Any Color. |
Color.red |
messageFont |
Font |
The font used for the message. |
Any Font. |
"Serif",0,10 |
messageHorizontalLocation |
double |
Location of the message in (0,1) axis coordinates. |
Any double. |
1.05 |
messageVerticalLocation |
double |
Location of the message in (0,1) axis coordinates. |
Any double. |
0.30 |
paintInterior |
boolean |
Whether the area inside the axes should be painted. |
true,false |
true |
pointColor |
Color |
The color of the point symbols. |
Any valid Color. |
Color.black |
pointColors(int k) |
Color |
The color of point set k. |
Any valid Color. |
Varied. |
pointSize |
int |
The size of the point symbols. |
0-20 |
2 |
pointSizes(int k) |
int |
The size of point set k. |
0-20 |
2 |
pointType |
String |
The type to be used for the point symbols. |
"Rectangle","+", |
"Rectangle" |
rightaxisBy |
double |
The distance between ticmarks on the right axis. |
Any double > 0. |
0.2 |
rightaxisFrom |
double |
The minimum value for the right axis. |
Any double. |
0.0 |
rightaxisLogscale |
boolean |
Whether axis is drawn as log base 10. |
true,false |
false |
rightaxisPower |
boolean |
Whether small and large numbers are shown with a power. |
true,false |
true |
rightaxisTicmarkColor |
Color |
The color to be used for the right axis ticmarks. |
Any Color. |
Color.black |
rightaxisTicmarkFont |
Font |
The font to be used for the right axis ticmarks. |
Any Font. |
"Serif",0,12 |
rightaxisTitle |
String |
The title displayed along the right axis. |
Any string, or "@" to generate a default title. |
"@" |
rightaxisTitleColor |
Color |
The color to be used for the z axis title. |
Any Color. |
Color.black |
rightaxisTitleFont |
Font |
The font to be used for the right axis title. |
Any Font. |
"Serif",0,12 |
rightaxisTo |
double |
The maximum value for the right axis. |
Any double > zaxisFrom. |
1.0 |
rightaxisType |
String |
The type of data on the axis. |
"Numeric","Character", |
"Numeric" |
rightMargin |
int |
The right margin as a percentage of the width of the canvas. |
0-50 |
20 |
showPointClickedMessage |
boolean |
Whether to display point coordinates. |
true,false |
false |
significantDigits |
int |
The number of signigicant digits to be displayed. |
2-20 |
6 |
ticmarkGap |
int |
Gap between the axes and the origin as a percentage of the width of the axes. |
0-10 |
4 |
ticmarkOrientation |
String |
The direction of the ticmarks relative to the axes. |
"In","Out","None" |
"in" |
ticmarkLength |
int |
Length of the ticmarks as a percentage of the width of the axes. |
0-10 |
2 |
topMargin |
int |
The top margin as a percentage of the height of the canvas. |
0-50 |
20 |
topTitleLine1 |
String |
The first line of the title displayed above the graph. |
Any string, or "@" to generate a default title. |
"@" |
topTitleLine1Color |
Color |
The color to be used for the first line of the top title. |
Any Color. |
Color.black |
topTitleLine1Font |
Font |
The font to be used for the first line of the top title. |
Any Font. |
"Serif",0,16 |
topTitleLine2 |
String |
The second line of the title displayed above the graph. |
Any string, or "@" to generate a default title. |
"@" |
topTitleLine2Color |
Color |
The color to be used for the second line of the top title. |
Any Color. |
Color.black |
topTitleLine2Font |
Font |
The font to be used for the second line of the top title. |
Any Font. |
"Serif",0,12 |
useDefaultFonts |
boolean |
Whether default fonts should be used. |
true,false |
true |
useDefaultScaling |
boolean |
Whether default scaling should be used. |
true,false |
true |
xaxisBy |
double |
The distance between ticmarks on the x axis. |
Any double > 0. |
0.2 |
xaxisFrom |
double |
The minimum value for the x axis. |
Any double. |
0.0 |
xaxisLogscale |
boolean |
Whether axis is drawn as log base 10. |
true,false |
false |
xaxisPower |
boolean |
Whether small and large numbers are shown with a power. |
true,false |
true |
xaxisTicmarkColor |
Color |
The color to be used for the x axis ticmarks. |
Any Color. |
Color.black |
xaxisTicmarkFont |
Font |
The font to be used for the x axis ticmarks. |
Any Font. |
"Serif",0,12 |
xaxisTitle |
String |
The title displayed along the x axis. |
Any string, or "@" to generate a default title. |
"@" |
xaxisTitleColor |
Color |
The color to be used for the x axis title. |
Any Color. |
Color.black |
xaxisTitleFont |
Font |
The font to be used for the x axis title. |
Any Font. |
"Serif",0,12 |
xaxisTo |
double |
The maximum value for the x axis. |
Any double > xaxisFrom. |
1.0 |
xaxisType |
String |
The type of data on the axis. |
"Numeric","Character", |
"Numeric" |
yaxisBy |
double |
The distance between ticmarks on the y axis. |
Any double > 0. |
0.2 |
yaxisFrom |
double |
The minimum value for the y axis. |
Any double. |
0.0 |
yaxisLogscale |
boolean |
Whether axis is drawn as log base 10. |
true,false |
false |
yaxisPower |
boolean |
Whether small and large numbers are shown with a power. |
true,false |
true |
yaxisTicmarkColor |
Color |
The color to be used for the y axis ticmarks. |
Any Color. |
Color.black |
yaxisTicmarkFont |
Font |
The font to be used for the y axis ticmarks. |
Any Font. |
"Serif",0,12 |
yaxisTitle |
String |
The title displayed along the y axis. |
Any string, or "@" to generate a default title. |
"@" |
yaxisTitleColor |
Color |
The color to be used for the y axis title. |
Any Color. |
Color.black |
yaxisTitleFont |
Font |
The font to be used for the y axis title. |
Any Font. |
"Serif",0,12 |
yaxisTo |
double |
The maximum value for the y axis. |
Any double > yaxisFrom. |
1.0 |
yaxisType |
String |
The type of data on the axis. |
"Numeric","Character", |
"Numeric" |
zaxisBy |
double |
The distance between ticmarks on the z axis. |
Any double > 0. |
0.2 |
zaxisFrom |
double |
The minimum value for the z axis. |
Any double. |
0.0 |
zaxisLogscale |
boolean |
Whether axis is drawn as log base 10. |
true,false |
false |
zaxisPower |
boolean |
Whether small and large numbers are shown with a power. |
true,false |
true |
zaxisTicmarkColor |
Color |
The color to be used for the z axis ticmarks. |
Any Color. |
Color.black |
zaxisTicmarkFont |
Font |
The font to be used for the z axis ticmarks. |
Any Font. |
"Serif",0,12 |
zaxisTitle |
String |
The title displayed along the z axis. |
Any string, or "@" to generate a default title. |
"@" |
zaxisTitleColor |
Color |
The color to be used for the z axis title. |
Any Color. |
Color.black |
zaxisTitleFont |
Font |
The font to be used for the z axis title. |
Any Font. |
"Serif",0,12 |
zaxisTo |
double |
The maximum value for the z axis. |
Any double > zaxisFrom. |
1.0 |
zaxisType |
String |
The type of data on the axis. |
"Numeric","Character", |
"Numeric" |
Other Public Methods
Name |
Description |
Arguments |
Return Value |
void getLastCursorPosition(double xy[2]) |
Returns the coordinates of the last mouse press. |
Mouse XY coordinates. |
None. |
int getLastPointClicked(double xyz[3]) |
Returns the row number and coordinates of the last highlighted point. |
Point XY or XYZ coordinates. |
Row number (0 origin). |
boolean hasFills() |
Returns true if graph contains filled areas. |
None. |
True or false. |
boolean hasGrid() |
Returns true if graph contains a grid. |
None. |
True or false. |
boolean hasLegends() |
Returns true if graph contains legends. |
None. |
True or false. |
boolean hasLegendTitle() |
Returns true if graph contains a legend title. |
None. |
True or false. |
boolean hasLines() |
Returns true if graph contains lines. |
None. |
True or false. |
boolean hasPoints() |
Returns true if graph contains points. |
None. |
True or false. |
boolean hasRightaxis() |
Returns true if graph contains right-axis ticmarks. |
None. |
True or false. |
boolean hasRightaxisTitle() |
Returns true if graph contains a right-axis title. |
None. |
True or false. |
boolean hasTopTitleLine1() |
Returns true if graph contains a top title. |
None. |
True or false. |
boolean hasTopTitleLine2() |
Returns true if graph contains a 2-line top title. |
None. |
True or false. |
boolean hasXaxis() |
Returns true if graph contains x-axis ticmarks. |
None. |
True or false. |
boolean hasXaxisTitle() |
Returns true if graph contains an x-axis title. |
None. |
True or false. |
boolean hasYaxis() |
Returns true if graph contains y-axis ticmarks. |
None. |
True or false. |
boolean hasYaxisTitle() |
Returns true if graph contains a y-axis title. |
None. |
True or false. |
boolean hasZaxis() |
Returns true if graph contains z-axis ticmarks. |
None. |
True or false. |
boolean hasZaxisTitle() |
Returns true if graph contains a z-axis title. |
None. |
True or false. |
boolean isThreed() |
Returns true if graph is 3-dimensional. |
None. |
True or false. |
void setErrorMessage(String S) |
Sets a message to be displayed instead of the defined graph. |
Message string. |
None. |
void updateScalingFromGraph() |
Sets from, to, and by members to current scaling. |
None. |
None. |
Added January, 2019
Name | Type | Description | Possible Values | Default Values |
borderColor | Color | Sets fill color for area around the graph. | Any valid Color. | Color.white |
paintBorder | boolean | Whether to fill area around graph with borderColor. | true,false | false |
xaxisTicmarkAngle | double | Orientation angle of ticmarks on X-axis. | 0,90 | 0 |
Name | Description | Arguments | Return Value |
setRightAxisFrom(String from, char type) | Sets start value for right axis. | Leftmost ticmark value, and scaling type ('N', 'D', 'M', '"Q', 'T' or 'S') | None |
setRightAxisTo(String to, char type) | Sets end value for right axis. | Rightmost ticmark value, and scaling type ('N', 'D', 'M', '"Q', 'T' or 'S') | None |
setXAxisFrom(String from, char type) | Sets start value for X axis. | Leftmost ticmark value, and scaling type ('N', 'D', 'M', '"Q', 'T' or 'S') | None |
setXAxisTo(String to, char type) | Sets end value for X axis. | Rightmost ticmark value, and scaling type ('N', 'D', 'M', '"Q', 'T' or 'S') | None |
setYAxisFrom(String from, char type) | Sets start value for Y axis. | Leftmost ticmark value, and scaling type ('N', 'D', 'M', '"Q', 'T' or 'S') | None |
setYAxisTo(String to, char type) | Sets end value for Y axis. | Rightmost ticmark value, and scaling type ('N', 'D', 'M', '"Q', 'T' or 'S') | None |
setZAxisFrom(String from, char type) | Sets start value for Z axis. | Leftmost ticmark value, and scaling type ('N', 'D', 'M', '"Q', 'T' or 'S') | None |
setZAxisTo(String to, char type) | Sets end value for Z axis. | Rightmost ticmark value, and scaling type ('N', 'D', 'M', '"Q', 'T' or 'S') | None |
Code Sample
//set filename
fileDataSource1.setFileName("c:\\statbeans2\\samples\\processdata.txt");
//read variable names from first row
fileDataSource1.setFindNames(true);
//select basic chart type
controlCharts1.setChartType("X-bar and R");
//specify variable containing data
controlCharts1.setXVariableName("Strength");
//specify variable defining subgroups
controlCharts1.setSubgroupSizeVariableName("Date");
//specify variable used to label x axis
controlCharts1.setIdentifierVariableName("Date");
//paint border light blue
controlChartsPlot1.setPaintBorder(true);
Color blue=new Color(135,206,250);
controlChartsPlot1.setBorderColor(blue);
//define size of chart
controlChartsPlot1.setBounds(16,16,550,350);
//set type of data
controlChartsPlot1.setXtype('D');
//set X-axis titles
controlChartsPlot1.setXaxisTitle("Date");
//set top title
//controlChartsPlot1.setTopTitleLine1("X-bar Chart");
//turn xaxis tickmarks vertical
controlChartsPlot1.setXaxisTicmarkAngle(90.0);
//reduce size of points
controlChartsPlot1.setPointSize(1);
//define xaxis scaling using dates
controlChartsPlot1.setUseDefaultXaxisScaling(false);
controlChartsPlot1.setXaxisFrom("1/1/2019",'D');
controlChartsPlot1.setXaxisTo("1/21/2019",'D');
controlChartsPlot1.setXaxisBy(5);
//add graph to display pane
getContentPane().add(controlChartsPlot1);
//define listeners
fileDataSource1.addDataChangeListener(controlCharts1.listenerForDataChange);
controlCharts1.addDataChangeListener(controlChartsPlot1.listenerForDataChange);
//read data and notify all listeners
fileDataSource1.readData();
fileDataSource1.updateListeners();
© 2025 Statgraphics Technologies, Inc.
The Plains, Virginia
CONTACT USHave you purchased Statgraphics Centurion or Sigma Express and need to download your copy?
CLICK HERE