MultiSelect プロパティ

複数選択が許可されているかどうかを示す値を取得または設定します。

構文

Visual Basic (宣言)
C#

Public Property MultiSelect As Boolean

public bool MultiSelect {get; set;}

プロパティ値

複数選択が許可されている場合はtrue。それ以外の場合はfalse。既定値はtrueです。

解説

MultiSelectプロパティがtrueに設定されている場合、GcMultiRowコントロールで複数の要素（セル、行）を選択できます。複数の要素を選択するには、［Ctrl］キーを押しながら選択する要素をクリックするか、セルの上でマウス左ボタンを押して選択する範囲をドラッグします。

MultiSelectプロパティを使用することで、ユーザーがGcMultiRowコントロールの複数の要素を選択し、選択されたすべての要素に対して操作を実行することを許可できます。たとえば、ユーザーが複数のセルを選択して右クリックし、表示されたショートカットメニューから選択されたセルに対して操作を実行することが可能です。

GcMultiRowコントロールで選択されているセルまたは行を確認するには、SelectedCellsプロパティまたはSelectedRowsプロパティにアクセスします。選択されているセルの数を確認するには、引数にMultiRowElementStates.Selectedを指定してGetCellCount(MultiRowElementStates)メソッドを呼び出します。選択されている行の数を取得するには、RowCollection.GetRowCountメソッドを使用します。大量のデータを操作しているときは、これらのメソッドを使用する方がコレクションに直接アクセスするよりも効率的です。

使用例

次のサンプルコードは、このプロパティを使用して選択動作をカスタマイズする方法を示します。このサンプルコードは、ViewModeクラスに示されている詳細なコード例の一部を抜粋したものです。

C#
Visual Basic

void allowMultiSelectCheckBox_CheckedChanged(object sender, EventArgs e)
{
    // Only can select one cell or row, when MultiSelect property is false.
    this.gcMultiRow1.MultiSelect = allowMultiSelectCheckBox.Checked;
}

Private Sub allowMultiSelectCheckBox_CheckedChanged(ByVal sender As Object, ByVal e As EventArgs) Handles allowMultiSelectCheckBox.CheckedChanged
    ' Only can select one cell or row, when MultiSelect property is false.
    Me.gcMultiRow1.MultiSelect = allowMultiSelectCheckBox.Checked
End Sub

参照

GcMultiRow クラス
 GcMultiRow メンバ