LayoutSerializationOptions.StoreAppearance Property

Gets or sets whether the control’s appearance 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 StoreAppearance { get; set; }

VB.NET

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

Property Value

Type	Default	Description
DefaultBoolean	Default	A value that specifies whether to store and restore the control’s appearance settings.

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 StoreAppearance
LayoutControl	.OptionsSerialization .StoreAppearance

Remarks

The StoreAppearance property specifies whether to save/load the control’s appearance settings from data storage when you call the SaveLayoutTo… and RestoreLayoutFrom… methods. The property affects the apperance settings of the following elements:

• Groups (LayoutItemContainer.AppearanceGroup)
• Items (BaseLayoutItem.AppearanceItemCaption)
• Tab pages (LayoutItemContainer.AppearanceTabPage).

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

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

• The StoreAppearance property is set to True.
• The StoreAppearance property is set to Default and any of the following properties is set to true: RestoreAppearanceItemCaption, RestoreAppearanceTabPage and RestoreLayoutGroupAppearanceGroup. Note that these properties are now hidden at design time; they are left for backward compatibility.