AutoPreviewEnabled プロパティ (UltraGridBand)

AutoPreview 領域が表示されるかどうかを決定する値を返すまたは設定します。

シンタックス

Visual Basic

'宣言
 
Public Property AutoPreviewEnabled As Boolean

C#

public bool AutoPreviewEnabled {get; set;}

解説

AutoPreview 領域はその行に関連付けられた複数のテキスト行を表示する手段で、その行の下に表示されます。表示するテキスト行の行数を指定し、行内のセルの値と指定したカスタムテキスト文字列のどちらを表示するかを選択できます。一般的な使用方法の 1 つは、グリッドが読み込みされたときに画面の外に初期表示されるメモ フィールドの内容を表示することです。

AutoPreviewEnabled プロパティは、指定されたバンドの行に AutoPreview 領域を表示できるかどうかを決定します。AutoPreview を有効にすると、UltraGridRow オブジェクトの AutoPreviewHidden プロパティを False に設定することで、その行の AutoPreview 領域を表示できます。

行の Description プロパティは、AutoPreview 領域に表示されるテキストを決定します。Description は AutoPreviewField プロパティによって指定される行内のフィールドを使用して、自動的に設定できます。または、コード (たとえば、InitializeRow イベント ハンドラーで) を介して明示的に設定できます。

使用例

Visual Basic

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

  Private Sub Button25_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button25.Click

      Dim band As UltraGridBand = Me.UltraGrid1.DisplayLayout.Bands(0)

      ' Set the AutoPreviewEnabled to enable row previews.
      band.AutoPreviewEnabled = True

      ' Set the AutoPrevieField to the field contents of which will be  displayed
      ' in the row preview.
      band.AutoPreviewField = "Address"

      ' Indent the text in row previews by 5 pixels
      band.AutoPreviewIndentation = 5

      ' Allow the row previews to display up to 4 lines of text if the text is 
      ' multiline.
      band.AutoPreviewMaxLines = 4

      ' Change how the row preview will look by setting RowPreviewAppearance 
      ' off the override.
      band.Override.RowPreviewAppearance.BackColor = Color.DarkBlue
      band.Override.RowPreviewAppearance.ForeColor = Color.LightYellow

      ' You can set the row preview appearance on per row basis overriding the
      ' settings on the Override.RowPreviewAppearance.
      Me.UltraGrid1.Rows(0).PreviewAppearance.BackColor = Color.Red

  End Sub

C#

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

private void button25_Click(object sender, System.EventArgs e)
{

	UltraGridBand band = this.ultraGrid1.DisplayLayout.Bands[0];
	 
	// Set the AutoPreviewEnabled to enable row previews.
	band.AutoPreviewEnabled = true;	
	 
	// Set the AutoPrevieField to the field contents of which will be  displayed
	// in the row preview.
	band.AutoPreviewField = "Address";
	 
	// Indent the text in row previes by 5 pixels
	band.AutoPreviewIndentation = 5;

	// Allow the row previews to display upto 4 lines of text if the text is 
	// multiline.
	band.AutoPreviewMaxLines = 4;
	 
	// Change how the row preview will look by setting RowPreviewAppearance 
	// off the override.
	band.Override.RowPreviewAppearance.BackColor = Color.DarkBlue;
	band.Override.RowPreviewAppearance.ForeColor = Color.LightYellow;

	// You can set the row preview appearance on per row basis overrideing the
	// settings on the Override.RowPreviewAppearance.
	this.ultraGrid1.Rows[0].PreviewAppearance.BackColor = Color.Red;

}