XRTable.ProcessHiddenCellMode Property

Specifies how to distribute the space that remains after some of the row’s visible cells are hidden. Affects only the table row whose cells were hidden.

Namespace : DevExpress.XtraReports.UI

Assembly : DevExpress.XtraReports.v25.2.dll

NuGet Package : DevExpress.Reporting.Core

csharp

[DefaultValue(ProcessHiddenCellMode.LeaveEmptySpace)]
[SRCategory(ReportStringId.CatBehavior)]
public ProcessHiddenCellMode ProcessHiddenCellMode { get; set; }

<SRCategory(ReportStringId.CatBehavior)>
<DefaultValue(ProcessHiddenCellMode.LeaveEmptySpace)>
Public Property ProcessHiddenCellMode As ProcessHiddenCellMode

Property Value

Type	Default	Description
ProcessHiddenCellMode	LeaveEmptySpace

An enumeration value that specifies how to distribute the space.

Available values:

Name	Description
LeaveEmptySpace

Empty space remains on a hidden cell’s location and other cells are not affected.

| | ResizeCellsEqually |

All visible cells are resized to equally divide the space that a hidden cell reserved.

| | ResizeCellsProportionally |

All visible cells are resized to proportionally divide the space that a hidden cell reserved based on their weights in the whole table width.

| | StretchPreviousCell |

A cell located to the left of the hidden cell is stretched to occupy the available space. If the hidden cell is the first in the row, the next cell is stretched.

| | StretchNextCell |

A cell located to the right of the hidden cell is stretched to occupy the available space. If the hidden cell is the last in the row, the previous cell is stretched.

| | DecreaseTableWidth |

The table width is decreased and visible cells are shifted to a hidden cell’s location without changing their size.

Remarks

This property is in effect for cells that are hidden in one of the following ways:

The cell’s XRControl.Visible property is set to false in the Properties window at design time.
An expression is specified for the cell’s XRControl.Visible property.
The cell’s XRControl.Visible property is set to false at runtime (for instance, in an XRControl.BeforePrint event handler).
In the cell’s XRControl.BeforePrint event handler, the event argument’s Cancel property is set to true.

The table below demonstrates how the space from hidden cells is distributed.

Mode

Description

| | --- | --- | |

Cell is visible

The following image illustrates what the original table looks like:

| |

StretchNextCell

A cell located to the right of the hidden cell is stretched to occupy the available space. If the hidden cell is the last in the row, the previous cell is stretched.

| |

StretchPreviousCell

A cell located to the left of the hidden cell is stretched to occupy the available space. If the hidden cell is the first in the row, the next cell is stretched.

| |

ResizeCellsEqually

All visible cells are resized to equally divide the available space.

| |

ResizeCellsProportionally

All visible cells are resized to proportionally divide the space that the hidden cell occupied based on their weights in the whole table width.

| |

DecreaseTableWidth

The table width is decreased and visible cells are shifted to the hidden cell’s location but cell sizes don’t change.

| |

LeaveEmptySpace

(the default mode)

Empty space remains at the hidden cell’s location and other cells are not affected.

See the Hiding Table Cells topic for more information.