2.2.4.8.19 DataPlot::GetPlotType

GetPlotType

1 Description
2 Syntax
3 Parameters
4 Return
5 Examples
6 Remark
7 See Also
8 Header to Include

Description

Get DataPlot type and also to get all the description strings.

Syntax

int GetPlotType( DataPlotStrings * pDescStrs = NULL, BASIC_PLOT_SETTINGS * pstPlotSettings = NULL )

Parameters

pDescStrs: [output] pointer to struct to receive strings on plot designations and range descriptions.
pstPlotSettings: [output] to receive basic plot settings like color.

Return

-1 if DataPlot is not a valid plot object, otherwise returns the plot type ID of one of the below value

IDM_PLOT_LINE

IDM_PLOT_SCATTER

IDM_PLOT_LINESYMB

IDM_PLOT_COLUMN

IDM_PLOT_AREA

IDM_PLOT_HILOCLOSE

IDM_PLOT_BOX

Examples

void DataPlot_GetPlotType_Ex1()
{
	//make sure there exists a graph with dataplots on it before running this code.
	GraphLayer gl = Project.ActiveLayer();
	if ( gl )
	{
		DataPlot dp = gl.DataPlots(0); //get the first dataplot on graphlayer		
		if( dp )
		{
			DataPlotStrings stDescStrs;
			int nPlotType = dp.GetPlotType(&stDescStrs); //returns integer value like IDM_PLOT_DOT, IDM_PLOT_LINE, IDM_PLOT_3D_LINE, etc.
			if ( nPlotType > 0 )
			{
				printf("PlotType of DataPlot %s is %d\n", stDescStrs.szY, nPlotType);
			}
		}
		else
		{
			printf("DataPlot is not a valid object");
		}
	}
}