GridView.PreviewFieldName Property

Gets or sets the name of the field whose values are displayed within preview sections.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v23.2.dll

NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation

Declaration

C#

[DefaultValue("")]
[DXCategory("Appearance")]
[XtraSerializableProperty]
public string PreviewFieldName { get; set; }

VB.NET

<DefaultValue("")>
<DXCategory("Appearance")>
<XtraSerializableProperty>
Public Property PreviewFieldName As String

Property Value

Type	Default	Description
String	String.Empty	A String value specifying the name of the field whose values are displayed within preview sections.

Remarks

The View’s GridOptionsView.ShowPreview option must be enabled to make preview sections visible. Note that you can handle the GridView.CalcPreviewText event to supply custom text to preview sections or to modify the text provided by the specified field.

Please refer to the Row Preview Sections topic for additional information.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the PreviewFieldName property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-grid-custom-print-cells-headers-in-print-preview/CS/GridBeforePrint/Form1.cs#L32

myGridView1.OptionsView.AutoCalcPreviewLineCount = false;
myGridView1.PreviewFieldName = "FirstName";
customerList = GetData();

VB.NET

winforms-grid-custom-print-cells-headers-in-print-preview/VB/GridBeforePrint/Form1.vb#L24

myGridView1.OptionsView.AutoCalcPreviewLineCount = False
myGridView1.PreviewFieldName = "FirstName"
customerList = GetData()