AutoPreview 領域はその行に関連付けられた複数のテキスト行を表示する手段で、その行の下に表示されます。表示するテキスト行の行数を指定し、行内のセルの値と指定したカスタムテキスト文字列のどちらを表示するかを選択できます。一般的な使用方法の 1 つは、グリッドが読み込みされたときに画面の外に初期表示されるメモ フィールドの内容を表示することです。
AutoPreviewEnabled プロパティは、指定されたバンドの行に AutoPreview 領域を表示できるかどうかを決定します。AutoPreview を有効にすると、UltraGridRow オブジェクトの AutoPreviewHidden プロパティを False に設定することで、その行の AutoPreview 領域を表示できます。
行の Description プロパティは、AutoPreview 領域に表示されるテキストを決定します。Description は AutoPreviewField プロパティによって指定される行内のフィールドを使用して、自動的に設定できます。または、コード(たとえば、InitializeRow イベント ハンドラーで)を介して明示的に設定できます。
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
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; }