FreezeLeftCellIndex プロパティ

コントロールを左側で固定する（スクロールしないようにする）セルのインデックスを取得または設定します。

構文

Visual Basic (宣言)
C#

Public Property FreezeLeftCellIndex As Integer

public int FreezeLeftCellIndex {get; set;}

プロパティ値

コントロールを左側で固定するセルのインデックスを表すSystem.Int32値。既定値は-1で、左側で固定されないことを意味します。

例外

例外	解説
System.ArgumentOutOfRangeException	指定された値が-1未満です。

解説

このプロパティの値が-1でない場合、セクションの左端から特定のセルの右端までの領域が固定されます。

このプロパティの値が行のセル数以上の場合、このプロパティは作用しません（ただし、例外はスローされません）。テンプレートを変更してセルの数を増やすか、このプロパティの値を有効な値に減らすと、このプロパティは有効になります。

セクションの左端から特定のセルの右端までの領域の幅と右固定セルの右端からセクションの右端までの領域の幅を足した値がコントロールの幅より大きい場合は、コントロール全体が固定されます。ユーザーがコントロールを縮小表示できない場合は、このような状態にならないようにすることをお勧めします。

使用例

次のサンプルコードは、このプロパティを使用してMulitRowコントロールの左側のセルを固定する方法を示します。このサンプルコードは、FreezeLinesプロパティに示されている詳細なコード例の一部を抜粋したものです。

C#
Visual Basic

void setLeftFreezeButton_Click(object sender, EventArgs e)
{
    // You can use FreezeLeftCellIndex instead of FreezeLeftCellName to indicate which cell will be frozen.
    if (string.IsNullOrEmpty(this.gcMultiRow1.FreezeLeftCellName))
    {
        // Freeze some rows in top of gcMultiRow.
        this.gcMultiRow1.FreezeLeftCellName = "textBoxCell1";
        // this.gcMultiRow1.FreezeLeftCellIndex = 0;
    }
    else
    {
        // Unfreeze rows in top of gcMultiRow.
        this.gcMultiRow1.FreezeLeftCellName = string.Empty;
        // this.gcMultiRow1.FreezeLeftCellIndex = -1;
    }
}

Private Sub setLeftFreezeButton_Click(ByVal sender As Object, ByVal e As EventArgs) Handles setLeftFreezeButton.Click
    ' You can use FreezeLeftCellIndex instead of FreezeLeftCellName to indicate which cell will be frozen.
    If String.IsNullOrEmpty(Me.gcMultiRow1.FreezeLeftCellName) Then
        ' Freeze some rows in top of gcMultiRow.
        ' this.gcMultiRow1.FreezeLeftCellIndex = 0;
        Me.gcMultiRow1.FreezeLeftCellName = "textBoxCell1"
    Else
        ' Unfreeze rows in top of gcMultiRow.
        ' this.gcMultiRow1.FreezeLeftCellIndex = -1;
        Me.gcMultiRow1.FreezeLeftCellName = String.Empty
    End If
End Sub

参照

GcMultiRow クラス
 GcMultiRow メンバ
 FreezeLeftCellName プロパティ
 FreezeLines プロパティ