BCGSuite for MFC
CBCGPChartTernarySeries

Detailed Description

The CBCGPChartTernarySeries class implements the functionality of ternary series.

A ternary chart is a diagram displaying the proportions of three values on three axes:

A data point for the ternary series is built from three Y components (defined in CBCGPChartData): CI_Y, CI_Y1, CI_Y2. The values of a data point always sum up to 100% . You can add the data using CBCGPChartVisualObject::AddChartDataYY1Y2 method.

Because the ternary series class is derived from CBCGPChartLineSeries, you can define a curve type (line, spline etc) and set closed shape (CBCGPChartLineSeries::CloseShape) to fill regions.

Use GetDataPointComponentPercent() to easily retrieve percentage of each component. Use special BCGPChartDataLabelOptions::m_content content flags to display ternary component values and their percentage in data labels and legends:

  • LC_A_TERNARY_PERCENTAGE
  • LC_B_TERNARY_PERCENTAGE
  • LC_C_TERNARY_PERCENTAGE
  • LC_A_TERNARY_VALUE
  • LC_B_TERNARY_VALUE
  • LC_C_TERNARY_VALUE
  • LC_ALL_TERNARY_VALUES
  • LC_ALL_TERNARY_PERCENTAGE
    See also
    CBCGPChartTernaryAxis
+ Inheritance diagram for CBCGPChartTernarySeries:

Public Member Functions

 CBCGPChartTernarySeriesConstructs a ternary series object.
 
 CBCGPChartTernarySeriesConstructs a ternary series object.
 
 GetDataPointComponentPercentReturns percentage of specified component.
 
 GetDataPointLabelTextReturns text of data point label.
 
 GetDefaultLegendContentOverridden. Returns the default legend content flags.
 
 GetMaxPercentageReturns the maximum component percentage in a series.
 
 GetMinPercentageReturns the minimum component percentage in a series.
 
 ScreenPointFromChartDataCalculates data point coordinates on the screen.
 
 SetMinMaxPercentageSets minimum and maximum percentages for component values in a series.
 
 SetMinMaxValuesSets minimum and maximum values for component values in a series.
 
 ShowOnPrimaryAxisOverridden. Sets related axes for a series.
 
- Public Member Functions inherited from CBCGPChartLineSeries
 CBCGPChartLineSeriesConstructs a CBCGPChartLineSeries object.
 
 CBCGPChartLineSeriesConstructs a CBCGPChartLineSeries object.
 
 CloseShapeTells the series to draw closed shape.
 
 EnableColorEachLineAllows to draw each series line with a distinct color.
 
 IsColorEachLineEnabledTells whether "color each line" mode is enabled.
 
 IsConnectFirstLastPointsTells whether the first and last points should be connected.
 
 IsFillClosedShapeTells whether the closed shape should be filled.
 
- Public Member Functions inherited from CBCGPChartSeries
 AddDataPointAdds a new data point to a series.
 
 AddDataPointAdds a new data point to a series.
 
 AddDataPointAdds a new data point to a series.
 
 AddDataPointAdds a new data point to a series.
 
 AddDataPointAdds a new data point to a series.
 
 AddDataPointAdds a new data point to a series.
 
 AddDataPointsAdds batch of data points.
 
 AddDataPointsOptimizedAdd batch of data point optimally
 
 AddEmptyDataPointAdds empty data point.
 
 AddEmptyDataPointAdds empty data point.
 
 AddEmptyDataPointAdds empty data point.
 
 CanBeConvertedToCategoryTells whether a series can be converted to the specified category.
 
 CanIncludeDataPointToLegendTells whether a data point can be displayed in a legend.
 
 ClearMinMaxValuesClears minimum and maximum series values.
 
 CopyDataPointsCopies all data points to a destination array.
 
 CopyFromSets a series from a source series.
 
 CreateErrorBarsAdds error bars to the series.
 
 EnableAutoColorDataPointsEnables automatic coloring of data points.
 
 EnableHistoryModeEnables "history" mode for any series.
 
 EnableUpdateAxesOnNewDataEnables or disables update of X axis when a new data point has been added.
 
 FindDataPointIndexFinds index of data point.
 
 GetAxesBoundingRectReturns a rectangle formed by axes a series is shown on.
 
 GetChartCategoryReturns series category.
 
 GetChartCtrlReturns a pointer to related chart visual objects.
 
 GetChartImplReturns a pointer to a current chart implementation.
 
 GetChartTypeReturns current series type (simple, stacked, full stacked, range).
 
 GetColorIndexReturns series color index.
 
 GetColorsReturns a set of colors used to display series elements, markers and labels.
 
 GetCurveTypeReturns a curve type used to draw series lines.
 
 GetDataBufferGets a pointer to array of double values, which can be used to store additional series values.
 
 GetDataPointAtReturns a pointer to a data point located at the specified index.
 
 GetDataPointCategoryNameReturns category name of a data point.
 
 GetDataPointColorIndexReturns a color index for the specified data point.
 
 GetDataPointCountReturns a number of data points in a series.
 
 GetDataPointFormatReturns data point formatting options.
 
 GetDataPointScreenPointReturns a screen point associated with a data point.
 
 GetDataPointScreenPointCountReturns the number of screen points associated with a data point.
 
 GetDataPointShape3DReturns a pointer to 3D shape object representing a data point on 3D diagram.
 
 GetDataPointValueReturns a data point value at the specified component index.
 
 GetFormulaReturns a formula used to generate series data points.
 
 GetGroupIDReturns series group ID.
 
 GetHistoryDepthReturns history depth for a series in "history" mode.
 
 GetLongDataOffsetGets offset of long data.
 
 GetLongDataXGives access to array of X values used for optimized mode.
 
 GetLongDataYGives access to array of Y values used for optimized mode.
 
 GetLongDataY1Gives access to array of Y1 values used for optimized mode.
 
 GetMaxValueReturns maximum series value for the specified component.
 
 GetMinValueReturns minimum series value for the specified component.
 
 GetSeriesFormatReturns series format.
 
 HasErrorBarsTells whether a chart series has error bars.
 
 IsBackgroundOrderTells whether a series has background order.
 
 IsHistoryModeTells whether a series works in history mode.
 
 IsOptimizedLongDataModeTells whether a series works in "optimized long data" mode.
 
 IsUpdateAxesOnNewDataEnabledTells whether related axes are updated when a new data point is added.
 
 IsVirtualModeTells whether a series works in virtual mode.
 
 RecalcMinMaxValuesRecalculates minimum and maximum series values.
 
 RecreateErrorBarsRecreate existing error bars.
 
 RemoveDataPointsRemoves data points.
 
 RemoveErrorBarsRemoves all previously created error bars.
 
 SetChartImplSets a chart implementation.
 
 SetChartTypeSets new series category and type.
 
 SetCurveTypeSets curve type.
 
 SetDataLabelAngleSets angle of data point's data label.
 
 SetDataLabelContentSets data label content.
 
 SetDataLabelContentPaddingSets data label content padding.
 
 SetDataLabelDataFormatSets data label data format.
 
 SetDataLabelDisplayKeyTells the data label display legend key.
 
 SetDataLabelDistanceFromMarkerSets distance between data label and data marker.
 
 SetDataLabelDrawBorderSets "draw border" option for the data labels.
 
 SetDataLabelDropLineToMarkerSets option to connect data label and data marker by line (draw callout).
 
 SetDataLabelFillSets data label background color.
 
 SetDataLabelFormatSets data label format.
 
 SetDataLabelLineColorSets data label line color (color of border and callout line).
 
 SetDataLabelLineWidthSets data label line width (width of border and callout).
 
 SetDataLabelOptionsSets data label formatting options.
 
 SetDataLabelPositionSets data label position.
 
 SetDataLabelSeparatorSets a separator string (a string that separates data label values).
 
 SetDataLabelStrokeStyleSets data label stroke style (style of border and callout).
 
 SetDataLabelTextFormatSets data label text format.
 
 SetDataLabelUnderlineSets data label underline option. Not compatible with "draw border".
 
 SetDataPoint3DLineThicknessSets thickness of lines on 3D line chart.
 
 SetDataPointCategoryNameSets data point category name.
 
 SetDataPointColorIndexSets data point color index.
 
 SetDataPointLabelRectCalled to store bounding rectangle of data label.
 
 SetDataPointScreenPointCalled to store screen position of data point.
 
 SetDataPointValueSets a new value for the specified data point at specified component index.
 
 SetDefaultFillGradientTypeSets default fill gradient type.
 
 SetFormulaCall this method to set a formula generating data points for the series.
 
 SetGroupIDSets series group ID.
 
 SetIgnoreNegativeValuesSets an option to ignore negative values.
 
 SetLegendLabelContentSpecifies the content to be displayed in the legend.
 
 SetLegendLabelFillColorSets legend label fill color.
 
 SetLegendLabelFormatSets legend label data format.
 
 SetLegendLabelTextColorSets text color of a legend label.
 
 SetLegendLabelTextFormatSets text format of a legend label.
 
 SetLongDataOffsetSets long data offset.
 
 SetMarkerFillSets marker fill brush for all data points, or for specified data point.
 
 SetMarkerFormatSets marker format for all data points, or for individual data point.
 
 SetMarkerLineColorSets marker line color for all data points, or for individual data point.
 
 SetMarkerLineWidthSets marker line width for all data points, or for specified data point.
 
 SetMarkerOptionsSets marker options for all markers, or for specified data point.
 
 SetMarkerShapeSets marker shape either for all data points in a series, or for specified data point.
 
 SetMarkerSizeSets marker size either for all markers in a series, or for specified data point.
 
 SetMarkerStrokeStyleSets stroke style either for all series marker lines, or for specified data point.
 
 SetMaxValueSets maximum component value.
 
 SetMinValueSets minimum component value.
 
 SetRelatedAxesDisplay a series on the specified axes.
 
 SetRelatedAxisDisplay a series on the specified axis.
 
 SetSeriesElementFormatSets formatting options for a data point.
 
 SetSeriesFillSets fill brush for all series elements, or for specified data point.
 
 SetSeriesFormatSets series format.
 
 SetSeriesLineColorSets color either for all series lines, or for specified data point.
 
 SetSeriesLineDashStyleSets dash style either for all series lines, or for specified data point.
 
 SetSeriesLineWidthSets line width either for all series lines, or for specified data point.
 
 SetSeriesStrokeStyleSets stroke style either for all series lines, or for specified data point.
 
 SetTreatNullsDefines series behavior when it encounters empty data.
 
 SetUseWordWrapForDataLabelsSets an option to use word wrapping for long data labels.
 
 SetVirtualModeEnables virtual mode for a series.
 
 ShowDataLabelShows or hides a data label for a data point, or for all data points in a series.
 
 ShowMarkerShows or hides a data marker for a specific data point, or for a whole series.
 
 UpdateAxesUsed in conjunction with "EnableHistoryMode" and updates axes when a new data point has been added.
 
- Public Member Functions inherited from CBCGPVisualDataObject
 CBCGPVisualDataObjectDefault constructor.
 
 CBCGPVisualDataObjectCopy constructor.
 
 CreateCopyCreates the copy.
 
 GetParentVisualGets the parent visual object.
 
 GetValueGets the value.
 
 SetValueSets a value.
 
- Public Member Functions inherited from CBCGPAnimationManager
 CBCGPAnimationManagerDefault constructor.
 
 GetAnimatedValueGets current animated value.
 
 GetAnimationDurationGets animation duration.
 
 GetLastAnimationErrorGets the animation error returned by recent call to Windows Animation API.
 
 IsAnimatedChecks if animation is running.
 
 StartAnimationStarts an animation.
 
 StartFlashAnimationStarts "flash" animation.
 
 StopAnimationStops an animation.
 

Additional Inherited Members

- Public Types inherited from CBCGPAnimationManager
enum  BCGPAnimationType
 
- Static Public Member Functions inherited from CBCGPAnimationManager
 IsAnimationSupportedByOSChecks if animation is supported by OS.
 
- Public Attributes inherited from CBCGPChartSeries
 m_bIncludeDataPointLabelsToLegendSpecifies whether data point labels should be included in the legend.
 
 m_bIncludeSeriesToLegendSpecifies whether include a series key and name to the legend.
 
 m_bVisibleShows or hides a series.
 
 m_nLegendKeyToLabelDistanceSpecifies distance between legend key and data label text.
 
 m_strDefaultTooltipNameSpecifies series name for tooltip.
 
 m_strSeriesNameSpecifies series name.
 
- Protected Member Functions inherited from CBCGPChartSeries
 DoMouseRotateCalled by the framework when user rotates the chart using mouse/gesture.
 
- Protected Member Functions inherited from CBCGPAnimationManager
 OnAnimationIdleCalled by the framework in an animation idle time.