FreezeRightCellIndex プロパティ

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

構文

Visual Basic (宣言)
C#

Public Property FreezeRightCellIndex As Integer

public int FreezeRightCellIndex {get; set;}

プロパティ値

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

例外

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

解説

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

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

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

使用例

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

C#
Visual Basic

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

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

参照

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