BCGControlBar Pro for MFC
CBCGPChartLongSeries

Detailed Description

The CBCGPChartLongSeries class implements a line series, which is optimized to handle a large amount of data (hundreds thousands of data points).

Because of optimization the series has some limitations: it can't display data markers and data labels.

The long data series ignores X values, all data points are displayed according to their index.

If a lot of data is displayed on a single pixel, it produces some "noise" on the diagram and slows down redrawing. Call SetFilterSimilarXValues() to reduce the "noise". The series will perform additional optimization and display average Y values calculated among all values falling on the same pixel (it may be not suitable for some cases, because average hides the real picture).

+ Inheritance diagram for CBCGPChartLongSeries:

Public Member Functions

 CBCGPChartLongSeriesConstructs a long data series object.
 
 AddDataPointAdds a new data point to a long data series.
 
 AddDataPointAdds a new data point to a long data series.
 
 AddDataPointAdds a new data point to a long data series.
 
 AddDataPointAdds a new data point to a long data series.
 
 EnableAutoColorDataPointsOverridden. Prevents coloring of individual data points for a long series.
 
 FindDataPointIndexShould not be called for a long data series.
 
 GetDataPointAtReturns a dummy data point with X and Y components set.
 
 GetDataPointCountReturn number of values in a long series.
 
 GetDataPointValueReturns a value located at the specified index.
 
 IsAutoColorDataPointsOverridden. Always returns FALSE.
 
 IsFilterSimilarXValuesTells whether the series works in "optimized" mode.
 
 IsOrderedXValuesTells whether data points are not ordered by X axis.
 
 MoveDataPointsMoves data points inside a series.
 
 RemoveAllDataPointsRemoves all data points from a series.
 
 RemoveDataPointsRemoves data points from a series.
 
 SetDataPointCountPreallocates the internal array of values.
 
 SetDataPointValueModifies a value at specified data point index.
 
 SetFilterSimilarXValuesOptimizes performance by displaying average calculated among all Y values falling on the same pixel.
 
 SetOrderedXValuesSpecifies whether data points are ordered by X axis. By default, the data points are ordered.
 
 SetSeriesDataSets data at the specified index.
 
- Public Member Functions inherited from CBCGPChartSeries
 AddDataPointAdds a new data point to a series.
 
 AddDataPointAdds a new data point to a series.
 
 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.
 
 EnableHistoryModeEnables "history" mode for any series.
 
 EnableUpdateAxesOnNewDataEnables or disables update of X axis when a new data point has been added.
 
 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.
 
 GetDataPointCategoryNameReturns category name of a data point.
 
 GetDataPointColorIndexReturns a color index for the specified data point.
 
 GetDataPointFormatReturns data point formatting options.
 
 GetDataPointLabelTextReturns a data point's label text.
 
 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.
 
 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.
 
 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.
 
 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.
 
 SetMinMaxValuesSets a new minimum or maximum 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.
 
 ShowOnPrimaryAxisShows a series on primary or secondary axes.
 
 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.