Cells プロパティ

この UltraTreeNode のセルを含む TreeNodeCellsCollection を返します。

シンタックス

Visual Basic

'宣言
 
Public ReadOnly Property Cells As TreeNodeCellsCollection

C#

public TreeNodeCellsCollection Cells {get;}

解説

Cells コレクションには、UltraTreeNodeCell オブジェクトのインスタンスが含まれます。Cells コレクションのメンバーにアクセスすると、関連付けられた UltraTreeNodeColumn のために UltraTreeNodeCell オブジェクトが作成されます。メモリを節約するため、UltraTree の内部ロジックでは UltraTreeNodeCell オブジェクトが不必要に作成されることはありません。セルの値を取得または設定する際、代替のメソッド (GetCellValue、SetCellValue を参照) を使用することで、UltraTreeNodeCell オブジェクトを多数作成することによって生じるパフォーマンスへの影響を避けることができます。

注: セルは、ノードの動作を制御する Override インスタンスに UltraTreeColumnSet が割り当てられているノードによってのみ表示されます ( ColumnSet プロパティを参照)。Override オブジェクトのすべてのプロパティと同様に、ColumnSet プロパティも複数の異なるレベルで設定できます。特定のノードの列構造を指定する UltraTreeColumnSet を調べるには、DisplayColumnSetResolved プロパティを使用します。



注: ノードは、DisplayColumnSetResolved プロパティによって参照される UltraTreeColumnSet に表示列が存在する場合にセルを表示しますが、ShowColumns プロパティを DefaultableBoolean.False に設定することでこの動作が起こらないようにできます。

使用例

Visual Basic

Imports Infragistics.Win
Imports Infragistics.Win.Layout
Imports Infragistics.Win.UltraWinTree

    Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click

        Dim cell As UltraTreeNodeCell = Me.ultraTree1.ActiveNode.Cells("CompanyName")

        '	If the cell's node is selected, use the appearance
        '	to make the cell more visually apparent.
        If cell.Node.Selected = False Then
            cell.Appearance.BackColor = Color.Red
            cell.Appearance.ForeColor = Color.White
        End If

        '	Assign an EditorWithText with a custom EmbeddableEditorOwnerBase
        '	derived implementation.
        cell.Editor = New EditorWithText(New CustomOwner(cell))

        '	Output the cell's displayed value to the debug window
        If cell.Column.NullText.Length = 0 AndAlso Not cell.Value Is Nothing Then
            Debug.WriteLine(cell.Text)
        Else
            Debug.WriteLine(cell.Column.NullText)
        End If

        '	Determine whether the cell is currently in view.
        Dim isInView As Boolean = (cell.UIElement Is Nothing = False)

    End Sub

C#

using Infragistics.Win;
using Infragistics.Win.Layout;
using Infragistics.Win.UltraWinTree;
using System.Diagnostics;

		private void button1_Click(object sender, System.EventArgs e)
		{
			UltraTreeNodeCell cell = this.ultraTree1.ActiveNode.Cells["CompanyName"];
			
			//	If the cell's node is selected, use the appearance
			//	to make the cell more visually apparent.
			if ( cell.Node.Selected == false )
			{
				cell.Appearance.BackColor = Color.Red;
				cell.Appearance.ForeColor = Color.White;
			}

			//	Assign an EditorWithText with a custom EmbeddableEditorOwnerBase
			//	derived implementation.
			cell.Editor = new EditorWithText( /*new CustomOwner(cell)*/ );

			//	Output the cell's displayed value to the debug window
			if ( cell.Column.NullText.Length == 0 && cell.Value != null )
				Debug.WriteLine( cell.Text );
			else
				Debug.WriteLine( cell.Column.NullText );
	
			//	Determine whether the cell is currently in view.
			bool isInView = cell.UIElement != null;
		}