LayoutSerializationOptions.StoreSpaceOptions Property

Gets or sets whether padding, margin, and distance settings are stored (restored) when the layout is saved to (loaded from) storage.

Namespace: DevExpress.XtraLayout

Assembly: DevExpress.XtraLayout.v21.1.dll

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

Declaration

C#

[DefaultValue(DefaultBoolean.Default)]
public virtual DefaultBoolean StoreSpaceOptions { get; set; }

VB.NET

<DefaultValue(DefaultBoolean.Default)>
Public Overridable Property StoreSpaceOptions As DefaultBoolean

Property Value

Type	Default	Description
DefaultBoolean	**Default**	A value that specifies whether to store and restore the distance settings of layout items.

Available values:

Name	Description
True	Corresponds to a Boolean value of true.
False	Corresponds to a Boolean value of false.
Default	The default behavior determined by the control’s logic.

Property Paths

You can access this nested property as listed below:

Object Type	Path to StoreSpaceOptions
DataLayoutControl	.OptionsSerialization .StoreSpaceOptions
LayoutControl	.OptionsSerialization .StoreSpaceOptions

Remarks

The StoreSpaceOptions property specifies whether to save/load the distance settings of layout items when you call the SaveLayoutTo… and RestoreLayoutFrom… methods. These settings are specified by the following options:

• BaseLayoutItem.TextToControlDistance and LayoutGroup.OptionsItemText.TextToControlDistance
• BaseLayoutItem.Padding and BaseLayoutItem.Spacing

Initially, when the StoreSpaceOptions property is set to Default, (de)serialization of these settings is disabled.

(De)Serialization of distance settings is enabled in the cases below:

• The StoreSpaceOptions property is set to True.
• The StoreSpaceOptions property is set to Default and any of the following properties is set to true: RestoreTextToControlDistance, RestoreGroupPadding, RestoreLayoutItemPadding, RestoreRootGroupPadding, RestoreTabbedGroupPadding, RestoreGroupSpacing, RestoreLayoutItemSpacing, RestoreRootGroupSpacing, RestoreTabbedGroupSpacing. Note that these properties are now hidden at design time; they are left for backward compatibility.