Cells プロパティ (Selected)

選択された UltraGridCell オブジェクトのコレクションへの参照を返します。このプロパティは実行時には読み取り専用です。このプロパティは設計時には使用できません。

シンタックス

Visual Basic

'宣言
 
Public ReadOnly Property Cells As SelectedCellsCollection

C#

public SelectedCellsCollection Cells {get;}

解説

このプロパティは、UltraGridCell オブジェクトのコレクションへの参照を返します。この参照は現在選択されている UltraGridCell オブジェクトへの参照を取得するために使用できます。この参照を使用して、返されたコレクションのプロパティまたはメソッドだけでなく、コレクション内のオブジェクトのプロパティまたはメソッドにもアクセスできます。

セルが選択および選択解除される時、その対応する UltraGridCell オブジェクトが追加され、このプロパティによって返される SelectedCells コレクションから削除されます。セルが選択または選択解除されると、BeforeSelectChange イベントが生成されます。

返される SelectedCells コレクションの Count プロパティは、行に属するか、現在選択されているセルの数を決定するために使用されます。

使用例

Visual Basic

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid
Imports System.Diagnostics

   Private Sub UltraGrid1_BeforeSelectChange(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.BeforeSelectChangeEventArgs) Handles ultraGrid1.BeforeSelectChange

       ' ユーザーが行、列、またはセルを選択したときに BeforeSelectChange を発生します
       ' 渡されたイベント引数の NewSelections プロパティは新しい選択を含みます
       ' Type は行、列、またはセルの選択が変更したかどうかを
       ' 指定します新しい選択をキャンセルするには、
       ' イベント引数の Cancel プロパティを設定しますキャンセルした場合、UltraGrid は
       ' 以前の選択に戻ります

       Debug.Write("BeforeSelectChange: ")

       ' タイプを使用して、行、列、またはセルが選択されたかどうかを確認します
       If e.Type Is GetType(UltraGridGroupByRow) Then

           ' 項目タイプはグループ行のため、その項目にアクセスするには Selected の Rows プロパティを使用します
           If e.NewSelections.Rows.Count = 0 Then
               Debug.WriteLine("Group-by rows are being unselected.")
           Else
               Debug.WriteLine(e.NewSelections.Rows.Count & " group-by rows are being selected.")
           End If

       ElseIf e.Type Is GetType(UltraGridRow) Then

           ' 項目タイプは行のため、その項目にアクセスするには Selected の Rows プロパティを使用します
           If e.NewSelections.Rows.Count = 0 Then
               Debug.WriteLine("Rows are being unselected.")
           Else
               Debug.WriteLine(e.NewSelections.Rows.Count & " rows are being selected.")
           End If

       ElseIf e.Type Is GetType(UltraGridColumn) Then

           ' 項目タイプは列のため、その項目にアクセスするには Selected の Columns プロパティを使用します
           If e.NewSelections.Columns.Count = 0 Then
               Debug.WriteLine("Columns are being unselected.")
           Else
               Debug.WriteLine(e.NewSelections.Columns.Count & " columns are being selected.")
           End If

       ElseIf e.Type Is GetType(UltraGridCell) Then

           ' 項目タイプはセルのため、その項目にアクセスするには Selected の Cells プロパティを使用します
           If e.NewSelections.Cells.Count = 0 Then
               Debug.WriteLine("Columns are being unselected.")
           Else
               Debug.WriteLine(e.NewSelections.Cells.Count & " cells are being selected.")
           End If

       End If
   End Sub

C#

using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;

private void ultraGrid1_BeforeSelectChange(object sender, Infragistics.Win.UltraWinGrid.BeforeSelectChangeEventArgs e)
{

	// ユーザーが行、列、またはセルを選択したときに BeforeSelectChange を発生します
	// 渡されたイベント引数の NewSelections プロパティは新しい選択を含みます
	// Type は行、列、またはセルの選択が変更されたかどうかを
	// 指定します新しい選択をキャンセルするには、
	// イベント引数の Cancel プロパティを設定しますキャンセルした場合、UltraGrid は
	// 以前の選択に戻ります

	Debug.Write( "BeforeSelectChange: " );

	// タイプを使用して、行、列、またはセルが選択されたかどうかを確認します
	if ( typeof( UltraGridGroupByRow ) == e.Type )
	{
		// 項目タイプはグループ行のため、その項目にアクセスするには Selected の Rows プロパティを使用します
		if ( e.NewSelections.Rows.Count == 0 )
			Debug.WriteLine( "Group-by rows are being unselected." );
		else
			Debug.WriteLine( e.NewSelections.Rows.Count + " group-by rows are being selected." );
	} 
	else if ( typeof( UltraGridRow ) == e.Type )
	{
		// 項目タイプは行のため、その項目にアクセスするには Selected の Rows プロパティを使用します
		if ( e.NewSelections.Rows.Count == 0 )
			Debug.WriteLine( "Rows are being unselected." );
		else
			Debug.WriteLine( e.NewSelections.Rows.Count + " rows are being selected." );
	}
	else if ( typeof( UltraGridColumn ) == e.Type )
	{
		// 項目タイプは列のため、その項目にアクセスするには Selected の Columns プロパティを使用します
		if ( e.NewSelections.Columns.Count == 0 )
			Debug.WriteLine( "Columns are being unselected." );
		else
			Debug.WriteLine( e.NewSelections.Columns.Count + " columns are being selected." );
	}
	else if ( typeof( UltraGridCell ) == e.Type )
	{
		// 項目タイプはセルのため、その項目にアクセスするには Selected の Cells プロパティを使用します
		if ( e.NewSelections.Cells.Count == 0 )
			Debug.WriteLine( "Columns are being unselected." );
		else
			Debug.WriteLine( e.NewSelections.Cells.Count + " cells are being selected." );
	}	
									
}