Skip to main content
Table of Contents

TTMSFNCDataGridDataGroupingOptions Class

Default grouping settings: summary rows, header merging, column hiding, row heights, header text, and the formatting of group calculations.

API unit family: TMSFNCDataGridData Inherits from: TPersistent

Syntax

GeneratedPascalC++
TTMSFNCDataGridDataGroupingOptions = class(TPersistent)
class PASCALIMPLEMENTATION TTMSFNCDataGridDataGroupingOptions : public System::Classes::TPersistent

Remarks

Reached through Options.Grouping. Each grouping level starts from these values in a TTMSFNCDataGridDataGroupOptions record that TTMSFNCDataGridData.OnGetGroupOptions can change per level. Changes take effect on the next grouping call, not on an existing grouping.

Properties

Name Description
AutoSort True sorts the rows by the grouped columns before groups are formed, so equal values become adjacent. Default is True.
CalculationFormat Format string applied to calculation results. Default is '%g'.
CalculationFormatType Formatting function used for calculation results: Format (gcfNumber) or FormatFloat (gcfFloat). Default is gcfNumber.
HeaderHeight Height, in logical pixels, of the group header rows inserted by grouping. Default is 30.
HideColumns True hides the grouped columns after grouping, since their values appear in the group headers. They are shown again by Ungroup. Default is False.
MergeDelimiter Text inserted between values when several columns are grouped at the same level. Default is ' ; '.
MergeHeader True merges each group header cell across the data columns. Default is True.
MergeSummary True merges a group calculation result cell from the first non-fixed column up to the calculated column. Default is False.
Summary True adds a summary row below each group to hold group calculation results. Default is True.
SummaryHeight Height, in logical pixels, of the group summary rows inserted by grouping. Default is 30.
SummaryInHeader When True, summary calculation results are shown inside the group header row instead of in a separate summary row below the group. Default is False.
UseFirstRowAsHeader True prefixes each group header value with the text of the grouped column's header cell (row 0), for example Country: Belgium. Default is True.

Used by