TableLayoutPanel.GetColumnSpan メソッド

.NET Framework クラス ライブラリ リファレンス

TableLayoutPanel.GetColumnSpan メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定した子コントロールがまたがる列の数を返します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Function GetColumnSpan ( _
    control As Control _
) As Integer

Visual Basic (使用法)

Dim instance As TableLayoutPanel
Dim control As Control
Dim returnValue As Integer

returnValue = instance.GetColumnSpan(control)

C#

public int GetColumnSpan (
    Control control
)

C++

public:
int GetColumnSpan (
    Control^ control
)

J#

public int GetColumnSpan (
    Control control
)

JScript

public function GetColumnSpan (
    control : Control
) : int

パラメータ

control

TableLayoutPanel の子コントロール。

戻り値
子コントロールがまたがる列の数。既定値は 1 です。

解説

列スパンは、他のコントロールと比べてかなり幅が広いコントロールを配置する場合に便利です。

このメソッドは、ColumnSpan プロパティによって呼び出されます。このプロパティは、デザイン時にパネルによって子コントロールに追加されます。

使用例

GetColumnSpan メソッドおよび SetColumnSpan メソッドを使用して、TableLayoutPanel 内の Button コントロールの幅を設定するコード例を次に示します。

Visual Basic

Private Sub toggleSpanBtn_Click( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) _
Handles toggleSpanBtn.Click

    Dim c As Control = Me.TableLayoutPanel1.GetControlFromPosition(0,
 0)

    If Not c Is Nothing
 Then

        Dim xSpan As Integer
 = Me.TableLayoutPanel1.GetColumnSpan(c)
        Dim ySpan As Integer
 = Me.TableLayoutPanel1.GetRowSpan(c)

        If xSpan > 1 Then

            xSpan = 1
            ySpan = 1

        Else

            xSpan = 2
            ySpan = 2

        End If

        Me.TableLayoutPanel1.SetColumnSpan(c, xSpan)
        Me.TableLayoutPanel1.SetRowSpan(c, ySpan)

    End If

End Sub

C#

private void toggleSpanBtn_Click(
    System.Object sender, 
    System.EventArgs e)
{
    Control c = this.TableLayoutPanel1.GetControlFromPosition(0,
 0);

    if ( c != null )
    {
        int xSpan = this.TableLayoutPanel1.GetColumnSpan(c);
        int ySpan = this.TableLayoutPanel1.GetRowSpan(c);

        if (xSpan>1)
        {
            xSpan = 1;
            ySpan = 1;
        }
        else
        {
            xSpan = 2;
            ySpan = 2;
        }

        this.TableLayoutPanel1.SetColumnSpan(c, xSpan);
        this.TableLayoutPanel1.SetRowSpan(c, ySpan);
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TableLayoutPanel クラス
TableLayoutPanel メンバ
System.Windows.Forms 名前空間
SetColumnSpan
GetRowSpan
ColumnCount
GetColumn