CBCGPChartTernaryAxis

Detailed Description

The CBCGPChartTernaryAxis class implements the functionality of a ternary axis used for Ternary Chart type.

A Ternary Chart (see CBCGPChartTernarySeries) uses three axes (for component A, B and C), which can be accessed using CBCGPChartVisualObject::GetChartAxis method with the following axis IDs:

• BCGP_CHART_A_TERNARY_AXIS
• BCGP_CHART_B_TERNARY_AXIS
• BCGP_CHART_C_TERNARY_AXIS

ternary axis is derived from CBCGPChartAxis and provides the same functionality with some limitations:

• IsVertical always returns FALSE
• PointFromValue method is not implemented (asserts in debug version). Use PointFromChartData() instead.
• There is no interval interlacing.
• GetBoundingRect for any ternary axis always returns a bounding rectangle of a triangle formed by the ternary axes.
• Minimum values on a ternary axis is always 0, maximum - 100 (the same is for minimum and maximum displayed values).
• Other limitations imposed by the nature of Ternary Chart.

Axis labels can be displayed in regular mode (0, 25, 50, 75, 100), 20/80 mode (0/100, 25/75, 50/50, 75/25, 100/0) and base 1 mode (0, 0.1, 0.25, 0.5, 0.75, 1.).

Use SetLabelMode() method to set the desired mode.

See also

CBCGPChartAxis, CBCGPChartTernarySeries

Inheritance diagram for CBCGPChartTernaryAxis:

Public Types
enum	TitleMode

Public Member Functions
	GetLabelMode	Returns current label mode.
	GetTitleMode	Returns current title mode.
	PointFromChartData	Given a Chart Data returns a point in Chart client coordinates.
	PointFromValue	Given a chart value returns a point in client coordinates. Do not use for a ternary axis.
	SetLabelMode	Sets new label mode.
	SetTitleMode	Sets new title mode.
Public Member Functions inherited from CBCGPChartAxis
	AddScaleBreak	Adds a new scale break.
	CalcMajorMinorUnits	Calculates major and minor units for an axis.
	CanBeScrolled	Tells whether an axis can be scrolled.
	CanDisplayDataBetweenTickMarks	Tells whether an axis can display data points positioned between tick marks.
	CanShowScrollBar	Specifies whether an axis can display a scroll bar.
	CanUseScaleBreaks	Tells whether an axis can display scale breaks.
	EnableAllUnitsOnFixedInterval	Specifies whether partially visible data points for a fixed interval width should be drawn.
	EnableIndependentZoom	Enables or disables independent zoom.
	EnableMajorUnitIntervalInterlacing	Enables major unit interlacing.
	EnableScaleBreaks	Enables or disables axis scale breaks.
	EnableScroll	Enables or disables axis scrolling.
	EnableZoom	Enables or disables axis zooming.
	GenerateScaleBreaks	Generates scale breaks.
	GetAxisGap	Gets the distance between two axes that share the same perpendicular axis.
	GetAxisPos	Gets axis start and end points in client coordinates.
	GetAxisRect	Gets an axis rectangle.
	GetAxisSize	Calculates axis size in pixels.
	GetBottomOffset	Gets axis offset from the bottom or left side of the diagram area.
	GetBoundingRects	Returns a list of bounding rectangles formed by this axis and its perpendicular axes.
	GetComponentIndex	Returns component index of chart data this axis uses to display values.
	GetCrossValuePos	Returns current cross value.
	GetCustomPerpendicularAxis	Returns a pointer to custom perpendicular axis.
	GetDisplayUnits	Returns displayed units.
	GetFirstInterlacedIntervalIndex	Returns first interlaced interval index.
	GetFixedIntervalWidth	Returns fixed interval width.
	GetFixedIntervalWidthScaled	Returns fixed interval width in device units taking into account DPI settings.
	GetIndexedSeries	Returns indexed series.
	GetInterlaceStep	Returns interlace step.
	GetLabelDistance	Returns distance between axis labels and the axis line.
	GetLogScaleBase	Returns current logarithmic scale base.
	GetMajorTickMarkLen	Returns size, in pixels, of major tick marks.
	GetMajorUnit	Returns major axis unit.
	GetMaxDisplayedValue	Returns maximum displayed value.
	GetMaxScrollValue	Returns maximum scroll value.
	GetMaxZoomInFactor	Returns maximal zoom factor.
	GetMinDisplayedValue	Returns minimum displayed value.
	GetMinorUnitCount	Returns minor unit count.
	GetMinScrollValue	Returns minimum scroll value.
	GetOppositeAxis	Returns a pointer to an opposite axis.
	GetRightOffsetAsNumberOfValues	Converts offset in pixels to offset in values, taking into account the current zoom level.
	GetRightOffsetInPixels	Returns offset from the right bound of plot area in pixels.
	GetScaleBreakCount	Returns a number of scale breaks.
	GetScaleBreaksOptions	Returns scale break options.
	GetScrollBarRect	Returns bounding rectangle of scroll bar.
	GetSplitBottom	Returns a pointer to a next split axis located at the bottom of this axis.
	GetSplitTop	Returns a pointer to a next split axis located at the top of this axis.
	GetTopOffset	Returns a top offset for an axis.
	GetValuesPerInterval	Returns a number of values per interval.
	HasSeries	Tells whether there is at least one series, which is displayed on an axis.
	HitTest	Retrieves hit test info for an axis.
	IsAllUnitsOnFixedInterval	Tells whether partially visible data points for a fixed interval width should be drawn.
	IsAlwaysShowScrollBar	Tells whether a scroll bar has an "always visible" flag set.
	IsAxisVisible	Tells whether an axis is visible, or not.
	IsComponentXSet	Tells whether X component has been set for at least one series that is displayed on an axis.
	IsDisplayDataBetweenTickMarks	Tells whether an axis displays data between tick marks.
	IsFixedDisplayRange	Tells whether an axis displays some predefined fixed range.
	IsFixedIntervalWidth	Tells whether an axis works in "fixed interval width" mode.
	IsFixedMajorUnit	Tells whether a fixed major unit is specified.
	IsFixedMaximumDisplayValue	Tells whether a fixed maximum displayed value has been specified.
	IsFixedMinimumDisplayValue	Tells whether a fixed minimum displayed value has been specified.
	IsIndependentZoomEnabled	Tells whether the independent zoom option is turned on or off.
	IsIndexedSeries	Tells whether an axis works in "indexed" mode.
	IsLogScale	Tells whether an axis has logarithmic scale.
	IsMajorGridLinesVisible	Tells whether an axis displays major grid lines, or not.
	IsMajorUnitIntervalInterlacingEnabled	Tells whether major unit interlacing is enabled.
	IsMinorGridLinesVisible	Tells whether an axis displays minor grid lines, or not.
	IsScrollEnabled	Tells whether an axis can be scrolled.
	IsZoomed	Tells whether an axis is zoomed.
	IsZoomEnabled	Tells whether zoom is enabled for an axis.
	OnDrawAxisName3D	Called to draw axis name for 3D chart.
	OnDrawScaleBreaks	Called to draw a scale break.
	OnDrawScrollBar	Called to draw a scroll bar.
	RemoveAllBreaks	Removes all scale breaks that have been added manually.
	RemoveCustomAxis	Called for a custom axis when it's about to be removed from the chart.
	Reset	Resets axis state to default.
	Scroll	Scrolls an axis.
	ScrollTo	Scrolls an axis to the specified value.
	SetAlwaysShowScrollBar	Enables an axis to always show a scroll bar.
	SetAutoDisplayRange	Sets automating display range (scaling).
	SetAutoIntervalWidth	Sets automatic interval width mode.
	SetAxisOffsets	Sets axis offsets.
	SetCustomPerpendicularAxis	Specifies a perpendicular axis for an axis.
	SetDisplayDataBetweenTickMarks	Causes data points to be displayed between tick marks.
	SetDisplayUnits	Sets display units.
	SetFirstInterlacedIntervalIndex	Sets index of first interlaced interval.
	SetFixedDisplayRange	Sets fixed display range.
	SetFixedIntervalWidth	Sets "fixed interval" mode.
	SetFixedMajorUnit	Sets fixed major unit.
	SetFixedMaximumDisplayValue	Sets fixed maximum displayed value.
	SetFixedMinimumDisplayValue	Sets fixed minimum displayed value.
	SetFixedUnitCount	Sets a value that fixes the number of displayed major units.
	SetIndexedSeries	Sets indexed series.
	SetInterlaceStep	Sets interlace step value.
	SetLogScale	Enables or disables logarithmic scale for the axis.
	SetMajorTickMarkLen	Sets length, in pixels, of major tick marks.
	SetMaximumValue	Sets the maximum value on an axis.
	SetMaxZoomInFactor	Sets maximal zoom factor.
	SetMinAllowedMajorUnit	Sets minimal allowed major unit value.
	SetMinimumValue	Sets the minimum value on an axis.
	SetMinorTickMarkLen	Sets length, in pixels, of minor tick marks.
	SetMinorUnitCount	Sets the minor unit count.
	SetMinThumbSize	Sets minimum thumb size.
	SetRightOffsetInPixels	Sets offset of last displayed value in pixels for charts in "fixed interval" mode.
	SetScrollBarSize	Sets scroll bar size.
	SetScrollRange	Defines a scroll range for an axis.
	SetVertical	Sets axis orientation.
	ShowMajorGridLines	Shows or hides major grid lines.
	ShowMinorGridLines	Shows or hides minor grid lines.
	ShowScrollBar	Enables an axis to display a scroll bar.
	Split	Splits an axis creating an additional custom axis.
	UnZoom	Sets zoom 100% on an axis.
	Zoom	Zooms an axis.

Additional Inherited Members
Public Attributes inherited from CBCGPChartAxis
	m_axisLabelsFormat	Defines appearance of axis labels.
	m_axisLabelType	Defines location of axis labels.
	m_axisLineFormat	Specifies an axis line style.
	m_axisNameFormat	Defines appearance of axis name.
	m_bAlwaysVisible	Forces an axis to be visible, even it does not have any related series.
	m_bDisplayAxisName	Specifies whether an axis name should be displayed, or not.
	m_bFormatAsDate	Puts an axis to "date/time" mode.
	m_bReverseOrder	Tells an axis to display data in reverse order.
	m_brInterval	Specifies alternative color for major unit interval interlacing.
	m_bVisible	Specifies whether an axis is visible or not.
	m_crossType	Specifies cross type for an axis.
	m_dblCrossOtherAxisValue	Specifies a value on a perpendicular axis where this axis crosses it.
	m_dblLabelDistance	Specifies distance between axis labels and axis line.
	m_majorGridLineFormat	Formats major grid lines.
	m_majorTickMarkType	Specifies major tick mark type.
	m_minorGridLineFormat	Formats minor grid lines.
	m_minorTickMarkType	Specifies minor tick mark type.
	m_nAxisID	Specifies axis ID.
	m_nMaxTotalLines	Specifies how many major units an axis can display.
	m_strAxisName	Specifies axis name.
	m_strDataFormat	Formats axis labels.
	m_szMaxFixedLabelSize	Declares maximal axis label size.
Protected Member Functions inherited from CBCGPChartAxis
	CBCGPChartAxis	Constructs and initializes a chart axis object.
	CBCGPChartAxis	Constructs and initializes a chart axis object.
	OnDrawScrollBar	Called to draw a scroll bar.
Protected Attributes inherited from CBCGPChartAxis
	m_nMajorTickMarkLen	Specifies length of major tick marks.
	m_nMinorTickMarkLen	Specifies length of minor tick marks.