CHART REFERENCE

ComboPlot Object Class

Overview

A Chart Object creates a Plot object of type ComboPlot when the chart type resource is set to XintCHART_TYPE_COMBO_PLOT. This is a special plot type that can create and manage other plot types to build composite plots.

Inherited Resources and Behavior

The ComboPlot object class inherits behavior and resources from the Xt Object, Graphic and Group object classes.

The class pointer is xintComboPlotObjectClass.
The class name is XintComboPlot.
The header file is included as <Xint/ComboPlot.h>.

The ComboPlot object class does not define any new resources.

Graphics Class Inherited Resources

ComboPlot inherits behavior and resources from the Graphic class. The set of resources that can be accessed along with the proper defaults is listed below.

Name Type Default Access
XmNcolor Pixel foreground CSG
XmNdashList char * NULL CSG
XmNfillColor Pixel "gray" CSG
XmNfillFilename char * NULL CSG
XmNfillPixmap Pixmap NULL CSG
XmNfillStyle int XintFILL_SOLID CSG
XmNfont char * "*Helvetica*-120-*" CSG
XmNhighlightMode int XintHIGHLIGHT_HANDLE CSG
XmNlineStyle int XintLINE_NONE CSG
XmNlineThickness int 1 CSG
XmNmove Boolean True CSG
XmNsensitive Boolean True CSG
XmNshape Boolean True CSG
XmNstippleColor Pixel foreground CSG

Name	Type	Default	Access
XmNcolor	Pixel	foreground	CSG
XmNdashList	char *	NULL	CSG
XmNfillColor	Pixel	"gray"	CSG
XmNfillFilename	char *	NULL	CSG
XmNfillPixmap	Pixmap	NULL	CSG
XmNfillStyle	int	XintFILL_SOLID	CSG
XmNfont	char *	"Helvetica-120-*"	CSG
XmNhighlightMode	int	XintHIGHLIGHT_HANDLE	CSG
XmNlineStyle	int	XintLINE_NONE	CSG
XmNlineThickness	int	1	CSG
XmNmove	Boolean	True	CSG
XmNsensitive	Boolean	True	CSG
XmNshape	Boolean	True	CSG
XmNstippleColor	Pixel	foreground	CSG

Functions

The following functions are defined for creating new plot types and retrieving plot components.

Function Name Description
XintComboPlotCreateNewPlot Creates a new plot type inside the combo plot.
XintComboPlotGetComponent Retrieves a component from a combo plot.

Function Name	Description
XintComboPlotCreateNewPlot	Creates a new plot type inside the combo plot.
XintComboPlotGetComponent	Retrieves a component from a combo plot.

XintComboPlotCreateNewPlot

This function creates a new plot object inside the ComboPlot object. You can use function XintChartAssociateData to attach data to this new plot object. The function returns the ID of the plot object that was created.

     Object XintComboPlotCreateNewPlot (...)

Object combo_plot ID of the ComboPlot object.
int plot_type Type of plot to create.

The argument plot_type can be one of the following constants:

Constant Description
XintPLOT_TYPE_BAR To create a BarLine plot.
XintPLOT_TYPE_PIE To create a Pie plot.
XintPLOT_TYPE_SURFACE_3D To create a Surface3D plot.
XintPLOT_TYPE_HIGH_LOW To create a HighLow plot.
XintPLOT_TYPE_HISTOGRAM To create a Histogram plot.
XintPLOT_TYPE_AREA To create a XYPlot configured as an area plot.
XintPLOT_TYPE_LINE To create a XYPlot configured as a line plot.
XintPLOT_TYPE_SCATTERED To create a XYPlot configured as a scattered plot.
XintPLOT_TYPE_BAR_3D To create a Bar3D plot.

Constant	Description
XintPLOT_TYPE_BAR	To create a BarLine plot.
XintPLOT_TYPE_PIE	To create a Pie plot.
XintPLOT_TYPE_SURFACE_3D	To create a Surface3D plot.
XintPLOT_TYPE_HIGH_LOW	To create a HighLow plot.
XintPLOT_TYPE_HISTOGRAM	To create a Histogram plot.
XintPLOT_TYPE_AREA	To create a XYPlot configured as an area plot.
XintPLOT_TYPE_LINE	To create a XYPlot configured as a line plot.
XintPLOT_TYPE_SCATTERED	To create a XYPlot configured as a scattered plot.
XintPLOT_TYPE_BAR_3D	To create a Bar3D plot.

XintComboPlotGetComponent

This function returns the object ID of a specified component of the ComboPlot. This function is similar to XintChartGetComponent, except that it provides one more argument to take into account the fact that multiple plots can be managed by a ComboPlot.

     Object XintComboPlotGetComponent (...)

Object combo_plot ID of the ComboPlot object.
int code Code for the component to return.
int index The index of the plot of interest (starts at 0).

The argument code can be one of the following constants:

Constant Description
XintCHART_COMPONENT_PLOT The code for the plot object.
XintCHART_COMPONENT_VERTICAL_AXIS The code for the vertical axis object.
XintCHART_COMPONENT_HORIZONTAL_AXIS The code for the horizontal axis object.

Constant	Description
XintCHART_COMPONENT_PLOT	The code for the plot object.
XintCHART_COMPONENT_VERTICAL_AXIS	The code for the vertical axis object.
XintCHART_COMPONENT_HORIZONTAL_AXIS	The code for the horizontal axis object.

The function returns NULL if argument index is out of range.

Macros

The XintIsComboPlot macro returns True if the specified object is a ComboPlot object. It returns False otherwise.

     Boolean XintIsComboPlot (Object object)

Object	combo_plot	ID of the ComboPlot object.
int	plot_type	Type of plot to create.