LayoutViewOptionsView.ViewMode Property

Gets or sets the card layout.

Namespace: DevExpress.XtraGrid.Views.Layout

Assembly: DevExpress.XtraGrid.v19.1.dll

Declaration

C#

[DefaultValue(LayoutViewMode.SingleRecord)]
[XtraSerializableProperty]
public virtual LayoutViewMode ViewMode { get; set; }

VB.NET

<DefaultValue(LayoutViewMode.SingleRecord)>
<XtraSerializableProperty>
Public Overridable Property ViewMode As LayoutViewMode

Property Value

Type	Default	Description
LayoutViewMode	**SingleRecord**	A LayoutViewMode value.

Available values:

Name	Description
SingleRecord	A single card is displayed at one time.
Row	Cards are arranged in a single row.
Column	Cards are arranged in a single column.
MultiRow	Cards are arranged in multiple rows.
MultiColumn	Cards are arranged in multiple columns.
Carousel	Cards are arranged in an ellipse using a transparency effect. Use the LayoutView.OptionsCarouselMode property to customize related display options.

Property Paths

You can access this nested property as listed below:

Object Type	Path to ViewMode
LayoutView	.OptionsView.ViewMode

Remarks

Use the ViewMode property to specify how cards are arranged within a View.

An end-user can switch between display modes by clicking a corresponding button within the Header Panel. You can disable this feature by setting a corresponding Enable…Button option to false. These options are available via the LayoutView.OptionsHeaderPanel object.

To specify how cards are arranged when a View is printed, see the LayoutViewOptionsPrint.PrintMode property.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ViewMode 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#

layoutview-how-to-customize-customizationform-e4245/CS/SampleLayoutView/MyLayoutView.cs#L169

    obj = grid as GridControl;
    (obj.MainView as LayoutView).OptionsView.ViewMode = PreviewLayoutViewMode;
}

how-to-automatically-scroll-the-layoutview-during-drag-and-drop-e2414/CS/WindowsApplication26/Form1.cs#L22

gridControl1.DataSource = GetDataTable();
layoutView1.OptionsView.ViewMode = DevExpress.XtraGrid.Views.Layout.LayoutViewMode.Column;
autoScrollHelper = new AutoScrollHelper(layoutView1);

how-to-replace-the-cursor-with-a-thumbnail-image-while-dragging-a-card-in-the-layoutview-e1884/CS/Form1.cs#L190

layoutView1.OptionsCustomization.AllowSort = false;
layoutView1.OptionsView.ViewMode = LayoutViewMode.MultiColumn;
layoutView1.Columns["Image"].ColumnEdit = repositoryItemPictureEdit1;

VB.NET

layoutview-how-to-customize-customizationform-e4245/VB/SampleLayoutView/MyLayoutView.vb#L277

    obj = TryCast(grid, GridControl)
    TryCast(obj.MainView, LayoutView).OptionsView.ViewMode = PreviewLayoutViewMode
End If

how-to-automatically-scroll-the-layoutview-during-drag-and-drop-e2414/VB/WindowsApplication26/Form1.vb#L20

gridControl1.DataSource = GetDataTable()
layoutView1.OptionsView.ViewMode = DevExpress.XtraGrid.Views.Layout.LayoutViewMode.Column
autoScrollHelper = New AutoScrollHelper(layoutView1)

how-to-replace-the-cursor-with-a-thumbnail-image-while-dragging-a-card-in-the-layoutview-e1884/VB/Form1.vb#L173

layoutView1.OptionsCustomization.AllowSort = False
layoutView1.OptionsView.ViewMode = LayoutViewMode.MultiColumn
layoutView1.Columns("Image").ColumnEdit = repositoryItemPictureEdit1