CellDisplayStyle プロパティ (UltraGridOverride)

CellDisplayStyle は、セルの描画方法を指定します。このプロパティを FormattedText または PlainText に設定すると、セルの描画速度が向上します。Default は FullEditorDisplay に解決されます。

シンタックス

Visual Basic

'宣言
 
Public Property CellDisplayStyle As CellDisplayStyle

C#

public CellDisplayStyle CellDisplayStyle {get; set;}

解説

CellDisplayStyle は、セルの描画方法を指定します。このプロパティを FormattedText または PlainText に設定すると、セルの描画速度が向上します。Default は FullEditorDisplay に解決されます。

FormattedText を指定すると、セル内に書式設定されたセル値が表示されます。PlainText を指定すると、書式設定を適用せずにセル値がテキストに変換されます。この場合は、単にセル値に対して ToString が呼び出され、変換されたテキストがセル内に表示されます。FullEditorDisplay を指定すると、セル値だけでなくボタンなどの編集要素も表示する埋め込み UI 要素が埋め込まれます。これは、PlainText および FormattedText に比べてややパフォーマンスに負荷がかかります。デフォルトの FullEditorDisplay を使用する利点は、エディターによってセル内に描画される編集要素が、セルが編集モードになるまで描画されない点です。

使用例

Visual Basic

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid

    Private Sub UltraGrid1_InitializeLayout(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.InitializeLayoutEventArgs) Handles UltraGrid1.InitializeLayout
        ' CellDisplayStyle can be set on the layout's Override in which case it
        ' will effect the whole grid.
        e.Layout.Override.CellDisplayStyle = CellDisplayStyle.PlainText

        ' It can be set on the override of a band in which case it will effect
        ' only that band.
        e.Layout.Bands(0).Override.CellDisplayStyle = CellDisplayStyle.PlainText

        ' It can also be set on a column in which case it will effect only that 
        ' column.
        e.Layout.Bands(0).Columns(0).CellDisplayStyle = CellDisplayStyle.FullEditorDisplay

        ' It can be also set on an individual cell.
        Dim cell As UltraGridCell = e.Layout.Grid.Rows(0).Cells(0)
        cell.CellDisplayStyle = CellDisplayStyle.FullEditorDisplay
    End Sub

C#

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

		private void ultraGrid1_InitializeLayout(object sender, Infragistics.Win.UltraWinGrid.InitializeLayoutEventArgs e)
		{
			// CellDisplayStyle can be set on the layout's Override in which case it
			// will effect the whole grid.
			e.Layout.Override.CellDisplayStyle = CellDisplayStyle.PlainText;

			// It can be set on the override of a band in which case it will effect
			// only that band.
			e.Layout.Bands[0].Override.CellDisplayStyle = CellDisplayStyle.PlainText;

			// It can also be set on a column in which case it will effect only that 
			// column.
			e.Layout.Bands[0].Columns[0].CellDisplayStyle = CellDisplayStyle.FullEditorDisplay;

			// It can be also set on an individual cell.
			UltraGridCell cell = e.Layout.Grid.Rows[0].Cells[0];
			cell.CellDisplayStyle = CellDisplayStyle.FullEditorDisplay;
		}