New to Telerik UI for WinForms? Start a free 30-day trial

Holds the style-backed formatting values for a table.

Definition

Constructors

Creates table properties associated with a document element.

C#
public TableProperties(DocumentElement owner)
Parameters:ownerDocumentElement

The document element whose table properties are represented.

Creates table properties associated with a style definition.

C#
public TableProperties(StyleDefinition owner)
Parameters:ownerStyleDefinition

The style definition that owns these properties.

Properties

Gets or sets the explicit table fill. Changing it while a theme background is active clears the theme color.

C#
[XamlSerializable]
public Color Background { get; set; }

Gets or sets the table's outer and internal borders, including defaults for cell edges marked as inherited.

C#
[XamlSerializable]
public TableBorders Borders { get; set; }

Gets or sets the default inset between each cell's content and its borders.

C#
[XamlSerializable]
public Padding CellPadding { get; set; }

Gets or sets the spacing used between cells and at the table edges during layout.

C#
[XamlSerializable]
public double CellSpacing { get; set; }

Gets or sets the number of consecutive columns in each alternating column band when column banding is enabled by TableLook.

C#
[XamlSerializable]
public int ColumnBandSize { get; set; }

Gets or sets the direction in which table cells are laid out, which also determines the leading edge for indentation.

C#
[XamlSerializable]
public FlowDirection FlowDirection { get; set; }

Gets or sets the table's horizontal alignment within the available layout width.

C#
[XamlSerializable]
public RadHorizontalAlignment HorizontalAlignment { get; set; }

Gets or sets whether columns use fixed preferred widths or are sized automatically from their content and available width.

C#
[XamlSerializable]
public TableLayoutMode LayoutMode { get; set; }

Gets or sets the table's width constraint as an automatic, fixed, or percentage width.

C#
[XamlSerializable]
public TableWidthUnit PreferredWidth { get; set; }

Gets or sets the number of consecutive rows in each alternating row band when row banding is enabled by TableLook.

C#
[XamlSerializable]
public int RowBandSize { get; set; }

Gets or sets the offset from the leading edge of a left-aligned table; layout applies it on the left in left-to-right flow and on the right in right-to-left flow.

C#
[XamlSerializable]
public double TableIndent { get; set; }

Gets or sets which table components receive conditional formatting, such as first or last rows and columns or alternating bands.

C#
[XamlCompositePropertySerializable]
public TableLook TableLook { get; set; }

Gets or sets the theme palette color used for the table fill. Changing an active theme fill to an explicit Background clears this value.

C#
[XamlSerializable(ThemeColorsEnum.none)]
public ThemeColorsEnum ThemeBackground { get; set; }

Gets or sets the shade metadata for the theme-based table fill.

C#
[XamlSerializable]
public string ThemeFillShade { get; set; }

Gets or sets the tint metadata for the theme-based table fill.

C#
[XamlSerializable]
public string ThemeFillTint { get; set; }

Methods

Creates another property set associated with the current document element.

C#
protected override DocumentElementPropertiesBase CreateInstance()
Returns:

DocumentElementPropertiesBase

A new TableProperties instance.

Overrides: DocumentElementPropertiesBase.CreateInstance()

Connects each table property to the corresponding table style property.

C#
protected override void InitProperties()

Overrides: DocumentElementPropertiesBase.InitProperties()

Propagates changed table-style properties to cells and their paragraph and span content, respecting conditional table-style masks.

C#
protected override void OnStylePropertyChangedOverride(StylePropertyChangeEventArgs args)
Parameters:argsStylePropertyChangeEventArgs

The changed property and, when applicable, its conditional table-style type.

Overrides: DocumentElementPropertiesBase.OnStylePropertyChangedOverride(StylePropertyChangeEventArgs)

Restricts the owning style definition to table styles.

C#
protected override void ValidateStyleType(StyleDefinition value)
Parameters:valueStyleDefinition

The style definition to validate.

Exceptions: InvalidOperationException

The style definition has a type other than Table.

Overrides: DocumentElementPropertiesBase.ValidateStyleType(StyleDefinition)