ColumnStyle Class

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Source:: ColumnStyle.cs

Source:: ColumnStyle.cs

Source:: ColumnStyle.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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: Object

TableLayoutStyle
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, Single)	Initializes a new instance of the ColumnStyle class using the supplied SizeType and width values.
ColumnStyle(SizeType)	Initializes a new instance of the ColumnStyle class using the supplied SizeType value.

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

Jaa