TablePanelEntity.Style Property

Gets or sets the size type of the current row/column.

Namespace: DevExpress.Utils.Layout

Assembly: DevExpress.Utils.v25.1.dll

NuGet Packages: DevExpress.Utils, DevExpress.Wpf.Core

Declaration

C#

[DefaultValue(TablePanelEntityStyle.AutoSize)]
[DXCategory("Layout")]
public TablePanelEntityStyle Style { get; set; }

VB.NET

<DefaultValue(TablePanelEntityStyle.AutoSize)>
<DXCategory("Layout")>
Public Property Style As TablePanelEntityStyle

Property Value

Type	Default	Description
TablePanelEntityStyle	AutoSize	The size type of the current row/column.

Available values:

Name	Description
AutoSize	Rows/columns are automatically resized to match their contents. Width and Height settings of these columns/rows are ignored. The AutoSizeDefaultTableElementLength property specifies the size for empty rows/columns of this type. You can also enable the TablePanel’s AutoSize property to automatically resize the panel to fit its contents.
Absolute	A row/column has a fixed width/height, in pixels. If the last row/column is of the Absolute size type and the TableLayout provides more space than needed, the row/column is stretched to fit this space.
Relative	Rows/columns of this size type divide the available space according to the ratio specified by their sizes. When you enable the TablePanel’s AutoSize setting, Relative mode is equivalent to AutoSize mode.
Separator	Rows and columns of this style serve as visual delimiters between their neighboring rows and columns. Separators cannot be resized and ignore their TablePanelColumn.Width and TablePanelRow.Height properties.

Remarks

C#

tablePanel1.Rows[1].Style = DevExpress.Utils.Layout.TablePanelEntityStyle.Absolute;
tablePanel1.Rows[1].Height = 50;

VB.NET

TablePanel1.Rows(1).Style = DevExpress.Utils.Layout.TablePanelEntityStyle.Absolute
TablePanel1.Rows(1).Height = 50

The TablePanel may contain rows and columns of different size types simultaneously. In this case, available space is distributed between rows and columns in the following order.

• First, space is allocated for rows/columns of the Absolute type.
• Second, space is allocated for rows/columns of the AutoSize type.
• Finally, the remaining space is distributed among rows/columns of the Relative type.

Auto-Size Mode

You can use the TablePanel.AutoSize and TablePanel.AutoSizeMode properties to make the panel auto-adjust its size to fit its contents. The Style property of individual rows and columns is interpreted as follows when you enable auto-size mode for the panel:

• Set the Style property for the row/column to Absolute to fix the row/column length.
• Set the Style property to AutoSize to make the row/column resize itself according to the row/column contents.
• The Relative option assigned to the Style property is interpreted as AutoSize.

Example

The following code snippet does the following:

• Adds rows and columns to a TablePanel
• Displays a button in the top-left cell.

C#

using DevExpress.Utils.Layout;
using DevExpress.XtraEditors;
using System.Windows.Forms;

namespace DXTablePanelDemo {
    public partial class Form1 : XtraForm
    {
        TablePanel tablePanel1;
        LabelControl labelControl1;
        public Form1()
        {
            InitializeComponent();

            // Create and configure a TablePanel.
            tablePanel1 = new TablePanel()
            {
                Name = "tablePanel1",
                Dock = DockStyle.Fill,
                ShowGrid = DevExpress.Utils.DefaultBoolean.True
            };

            // Add 3 columns.
            tablePanel1.Columns.Add(new TablePanelColumn(TablePanelEntityStyle.AutoSize, 0));   // Adjusts the column width to cell content. 
            tablePanel1.Columns.Add(new TablePanelColumn(TablePanelEntityStyle.Relative, 1));   // Takes 1 share of the remaining space.
            tablePanel1.Columns.Add(new TablePanelColumn(TablePanelEntityStyle.Relative, 2));   // Takes 2 shares of the remaining space.

            // Add 3 rows.
            tablePanel1.Rows.Add(new TablePanelRow(TablePanelEntityStyle.AutoSize, 0)); // Adjusts the row height to cell content.
            tablePanel1.Rows.Add(new TablePanelRow(TablePanelEntityStyle.Relative, 1)); // Takes 1 share of the remaining height.
            tablePanel1.Rows.Add(new TablePanelRow(TablePanelEntityStyle.Absolute, 60)); // Fixed height = 60 pixels.

            // Access the third row and modify its height.
            tablePanel1.Rows[0].Height = 80;

            labelControl1 = new LabelControl() { Text = "Cell [0; 0]" };
            tablePanel1.Controls.Add(labelControl1);

            // Display the labelControl1 in the top left cell.
            tablePanel1.SetCell(labelControl1, 0, 0);

            Controls.Add(tablePanel1);
        }
    }
}

VB.NET

Imports DevExpress.Utils.Layout
Imports DevExpress.XtraEditors
Imports System.Windows.Forms

Namespace DXTablePanelDemo
    Partial Public Class Form1
        Inherits XtraForm

        Private tablePanel1 As TablePanel
        Private labelControl1 As LabelControl

        Public Sub New()
            InitializeComponent()

            ' Create and configure a TablePanel.
            tablePanel1 = New TablePanel() With {
                .Name = "tablePanel1",
                .Dock = DockStyle.Fill,
                .ShowGrid = DevExpress.Utils.DefaultBoolean.True
            }

            ' Add 3 columns.
            tablePanel1.Columns.Add(New TablePanelColumn(TablePanelEntityStyle.AutoSize, 0))  ' Adjusts the column width to cell content.
            tablePanel1.Columns.Add(New TablePanelColumn(TablePanelEntityStyle.Relative, 1))  ' Takes 1 share of the remaining space.
            tablePanel1.Columns.Add(New TablePanelColumn(TablePanelEntityStyle.Relative, 2))  ' Takes 2 shares of the remaining space.

            ' Add 3 rows.
            tablePanel1.Rows.Add(New TablePanelRow(TablePanelEntityStyle.AutoSize, 0))  ' Adjusts the row height to cell content.
            tablePanel1.Rows.Add(New TablePanelRow(TablePanelEntityStyle.Relative, 1))  ' Takes 1 share of the remaining height.
            tablePanel1.Rows.Add(New TablePanelRow(TablePanelEntityStyle.Absolute, 60)) ' Fixed height = 60 pixels.

            ' Access the first row and modify its height.
            tablePanel1.Rows(0).Height = 80

            ' Create a label and add it to the panel.
            labelControl1 = New LabelControl() With {
                .Text = "Cell [0; 0]"
            }
            tablePanel1.Controls.Add(labelControl1)

            ' Display the labelControl1 in the top left cell.
            tablePanel1.SetCell(labelControl1, 0, 0)

            Controls.Add(tablePanel1)
        End Sub
    End Class
End Namespace