AutoPreviewField プロパティ

AutoPreview 領域に表示されるテキストを提供するのに使用される、フィールドの名前を返すまたは設定します。

シンタックス

Visual Basic

'宣言
 
Public Property AutoPreviewField As String

C#

public string AutoPreviewField {get; set;}

解説

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

AutoPreviewField プロパティは、AutoPreview 領域を格納するために使用されるデータ フィールドを指定します。指定されたフィールドにどのような値があるとしても、AutoPreview 領域に表示されます。

使用例

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;

}