Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TcxPivotGridField.CollapseAll Method

In This Article

Collapses all the columns or rows that correspond to the current field.

#Declaration

Delphi
procedure CollapseAll;

#Remarks

When the current field is placed within the column header area the CollapseAll method collapses all the grouping columns that correspond to this field. When the current field is placed within the row header area the CollapseAll method collapses all the grouping rows that correspond to this field.

To expand or collapse a specific grouping item (a grouping row or column), you need to locate it within the pivot grid’s display information which is accessible via the ViewData property and set the item’s Expanded property to an appropriate value.

You can set the field’s Options.AlwaysExpanded property to True to expand all the field’s grouping values and keep them expanded, regardless of end-user actions and layout changes.

The following code snippet demonstrates how to collapse the grouping column that corresponds to a grouping value of 1 of the DBPivotGridPurchaseDate field.

var
  AGroupItem: TcxPivotGridGroupItem;
begin
  // ...
  DBPivotGrid.BeginUpdate;
  with DBPivotGrid.ViewData do
  begin
    for I := 0 to ColumnCount - 1 do
    begin
      AGroupItem := Columns[I].GetGroupItemByField(DBPivotGridPurchaseDate);
      if (AGroupItem <> nil) and (AGroupItem.Value = 1) then
      begin
        AGroupItem.Expanded := False;
        break;
      end;
    end;
  end;
  DBPivotGrid.EndUpdate;
end;
See Also