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.2.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	true. DefaultBoolean.True has a constant value of 0, while the standard true value corresponds to a value of 1. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
False	false. DefaultBoolean.False has a constant value of 1, while the standard false value corresponds to a value of 0. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
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
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.