OptionsLayoutBase.FullLayout Property

Returns an OptionsLayoutBase object whose settings indicate that the full layout of the control should be stored to and restored from storage (a stream, xml file or system registry).

Namespace: DevExpress.Utils

Assembly: DevExpress.Data.v19.2.dll

Declaration

C#

public static OptionsLayoutBase FullLayout { get; }

VB.NET

Public Shared ReadOnly Property FullLayout As OptionsLayoutBase

Property Value

Type	Description
OptionsLayoutBase	A OptionsLayoutBase object whose settings indicate that the full layout of the control should be stored to/restored from storage.

Property Paths

You can access this nested property as listed below:

Show 27 property paths

Library	Object Type	Path to FullLayout
WinForms Controls	BarManager	.OptionsLayout.FullLayout
	ToolbarFormManager	.OptionsLayout.FullLayout
	GanttControl	.OptionsLayout.FullLayout
	AdvBandedGridView	.OptionsLayout.FullLayout
	BandedGridView	.OptionsLayout.FullLayout
	BaseView	.OptionsLayout.FullLayout
	ColumnView	.OptionsLayout.FullLayout
	CardView	.OptionsLayout.FullLayout
	GridView	.OptionsLayout.FullLayout
	LayoutView	.OptionsLayout.FullLayout
	WinExplorerView	.OptionsLayout.FullLayout
	PivotGridControl	.OptionsLayout.FullLayout
	DocumentViewerBarManager	.OptionsLayout.FullLayout
	PrintBarManager	.OptionsLayout.FullLayout
	SchedulerControl	.OptionsLayout.FullLayout
	ResourcesTree	.OptionsLayout.FullLayout
	TreeList	.OptionsLayout.FullLayout
	PropertyGridControl	.OptionsLayout.FullLayout
	VGridControl	.OptionsLayout.FullLayout
	VGridControlBase	.OptionsLayout.FullLayout
ASP.NET Controls and MVC Extensions	ASPxPivotGrid	.OptionsLayout.FullLayout
	PivotGridWebOptionsLayout	.FullLayout.FullLayout
	MVCxPivotGrid	.OptionsLayout.FullLayout
Reporting	XRPivotGrid	.OptionsLayout.FullLayout
	XRDesignBarManager	.OptionsLayout.FullLayout
	XRDesignFieldList	.OptionsLayout.FullLayout
	XRDesignReportExplorer	.OptionsLayout.FullLayout

Remarks

A control can provide methods to save only specific options to and restore them from storage (a stream, xml file or system registry). Such methods take a OptionsLayoutBase parameter, and this determines which settings should be affected. To affect all the possible settings when the layout is stored or restored, you can pass the FullLayout object as this parameter.

The following is applied when restoring a layout in the XtraGrid control, using one of its RestoreLayoutFrom… methods, taking the FullLayout object as a parameter. Columns added to a View after the layout has been saved will be destroyed on restoring the layout. To retain the newly added columns when restoring the layout, do not call the RestoreLayoutFrom… method with the FullLayout object as a parameter. Use one of the following solutions instead:

• Use the RestoreLayoutFrom… method overload without parameters to restore the layout. Before calling this method, enable the OptionsColumnLayout.AddNewColumns option, which is available via the View’s ColumnView.OptionsLayout property.
• Create a OptionsLayoutGrid object, enable its Columns.AddNewColumns option, and pass it to the RestoreLayoutFrom… method.

Related GitHub Examples

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

how-to-save-layout-and-collapsed-state-to-the-same-stream-e2404/CS/WindowsApplication53/PivotHelper.cs#L17

{
    pivot.SaveLayoutToStream(layoutStream, PivotGridOptionsLayout.FullLayout);
    s.layout = layoutStream.ToArray();

how-to-save-load-field-values-collapsed-states-together-with-pivot-grids-layout-e20014/CS/XtraPivotGrid_RestoreLayoutExample/Form1.cs#L25

layoutStream = new MemoryStream();
pivotGridControl1.SaveLayoutToStream(layoutStream, OptionsLayoutBase.FullLayout);
collapseStateStream.Dispose();

how-to-customize-the-resulting-file-during-printing-exporting-gridcontrol-e2722/CS/WindowsApplication1/GridExportHelper.cs#L60

    layoutStream.Position = 0;
    ExportedView.RestoreLayoutFromStream(layoutStream, OptionsLayoutBase.FullLayout);
}

how-to-include-custom-data-in-the-gridviews-saving-and-restoring-layout-mechanism-e2522/CS/Serialization/MyXmlXtraSerializer.cs#L25

if ( options == null )
    options = OptionsLayoutBase.FullLayout;

how-to-restore-only-specific-views-settings-from-the-previously-stored-layout-file-e2841/CS/FilterDeserializer/Form1.cs#L27

private void btnSaveLayout_Click(object sender, EventArgs e) {
    gridView1.SaveLayoutToXml(layoutFileName, DevExpress.Utils.OptionsLayoutGrid.FullLayout);
}

VB.NET

how-to-save-layout-and-collapsed-state-to-the-same-stream-e2404/VB/WindowsApplication53/PivotHelper.vb#L14

Using layoutStream As New MemoryStream()
    pivot.SaveLayoutToStream(layoutStream, PivotGridOptionsLayout.FullLayout)
    s.layout = layoutStream.ToArray()

how-to-save-load-field-values-collapsed-states-together-with-pivot-grids-layout-e20014/VB/XtraPivotGrid_RestoreLayoutExample/Form1.vb#L25

layoutStream = New MemoryStream()
pivotGridControl1.SaveLayoutToStream(layoutStream, OptionsLayoutBase.FullLayout)
collapseStateStream.Dispose()

how-to-customize-the-resulting-file-during-printing-exporting-gridcontrol-e2722/VB/GridExportHelper.vb#L49

    layoutStream.Position = 0
    ExportedView.RestoreLayoutFromStream(layoutStream, OptionsLayoutBase.FullLayout)
End Sub

how-to-include-custom-data-in-the-gridviews-saving-and-restoring-layout-mechanism-e2522/VB/Serialization/MyXmlXtraSerializer.vb#L24

If options Is Nothing Then
    options = OptionsLayoutBase.FullLayout
End If

how-to-restore-only-specific-views-settings-from-the-previously-stored-layout-file-e2841/VB/FilterDeserializer/Form1.vb#L30

Private Sub btnSaveLayout_Click(ByVal sender As Object, ByVal e As EventArgs) Handles btnSaveLayout.Click
    gridView1.SaveLayoutToXml(layoutFileName, DevExpress.Utils.OptionsLayoutGrid.FullLayout)
End Sub