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.v19.1.dll
NuGet Packages: DevExpress.Reporting.Core, DevExpress.WindowsDesktop.Core
Declaration
[DefaultValue(ProcessHiddenCellMode.LeaveEmptySpace)]
[SRCategory(ReportStringId.CatBehavior)]
public ProcessHiddenCellMode ProcessHiddenCellMode { get; set; }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 Property grid 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.