ColumnStyle Class

Definition

Represents the look and feel of a column in a table layout.

public ref class ColumnStyle : System::Windows::Forms::TableLayoutStyle
public class ColumnStyle : System.Windows.Forms.TableLayoutStyle
type ColumnStyle = class
    inherit TableLayoutStyle
Public Class ColumnStyle
Inherits TableLayoutStyle
Inheritance
ColumnStyle

Examples

The following code example demonstrates how to extract a ColumnStyle from a TableLayoutColumnStyleCollection.

This code example is part of a larger example provided for the TableLayoutPanel class.

private void toggleColumnStylesBtn_Click(
    System.Object sender, 
    System.EventArgs e)
{
    TableLayoutColumnStyleCollection styles = 
        this.TableLayoutPanel1.ColumnStyles;

    foreach( ColumnStyle style in styles )
    {
        if( style.SizeType == SizeType.Absolute )
        {
            style.SizeType = SizeType.AutoSize;
        }
        else if( style.SizeType == SizeType.AutoSize )
        {
            style.SizeType = SizeType.Percent;

            // Set the column width to be a percentage
            // of the TableLayoutPanel control's width.
            style.Width = 33;
        }
        else
        {
            // Set the column width to 50 pixels.
            style.SizeType = SizeType.Absolute;
            style.Width = 50;
        }
    }
}
Private Sub toggleColumnStylesBtn_Click( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles toggleColumnStylesBtn.Click

    Dim styles As TableLayoutColumnStyleCollection = _
    Me.TableLayoutPanel1.ColumnStyles

    For Each style As ColumnStyle In styles

        If style.SizeType = SizeType.Absolute Then

            style.SizeType = SizeType.AutoSize

        ElseIf style.SizeType = SizeType.AutoSize Then

            style.SizeType = SizeType.Percent

            ' Set the column width to be a percentage
            ' of the TableLayoutPanel control's width.
            style.Width = 33

        Else

            ' Set the column width to 50 pixels.
            style.SizeType = SizeType.Absolute
            style.Width = 50

        End If

    Next

End Sub

Remarks

The ColumnStyle class represents the user interface (UI) characteristics of column in a TableLayoutPanel. The styles for all the columns in such a table are collected in the TableLayoutPanel.ColumnStyles property.

This simple class offers the Width and SizeType properties for a column.

Constructors

ColumnStyle()

Initializes a new instance of the ColumnStyle class to its default state.

ColumnStyle(SizeType)

Initializes a new instance of the ColumnStyle class using the supplied SizeType value.

ColumnStyle(SizeType, Single)

Initializes a new instance of the ColumnStyle class using the supplied SizeType and width values.

Properties

SizeType

Gets or sets a flag indicating how a row or column should be sized relative to its containing table.

(Inherited from TableLayoutStyle)
Width

Gets or sets the width value for a column.

Methods

Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Returns a string that represents the current object.

(Inherited from Object)

Applies to

See also