TDimensionItems.AddDerivedField Method

Adds a derived average summary to the end of the Items array.

Pascal

function AddDerivedField(Index: Integer; dimType: tDimFlags): Integer;

C++

__fastcall int AddDerivedField(int Index, tDimFlags dimType);

Description

Summaries that represent average values are not taken directly from the source dataset of a decision cube, but are derived from count summaries and summation summaries. AddDerivedField creates a dimension item for an average summary. The Index parameter specifies the index of an existing dimension item whose BaseName property specifies the field over which averages should be computed. AddDerivedField checks for the summary dimension items needed to derive the average. If both an average and a summation are available for the base field, AddDerivedField creates the average summary dimension item. AddDerivedField returns true if the dimension item is successfully created, false otherwise.

Note: The DimType (Delphi) or dimType (C++) parameter is currently ignored. Descendants of AddDerivedField can override this method to derive other types of dimension items. In this case, DimType/dimType should specify the type of derived dimension item that should be created. When overriding AddDerivedField, call the inherited method if DimType/dimType is dimAverage.