LayoutSerializationOptions.StoreText Property

Gets or sets whether captions of layout items and groups are stored (restored) when the layout is saved to (loaded from) storage.

Namespace: DevExpress.XtraLayout

Assembly: DevExpress.XtraLayout.v22.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

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

VB.NET

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

Property Value

Type	Default	Description
DefaultBoolean	Default	A value that specifies whether to store and restore the text of layout items and groups.

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

Remarks

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

• BaseLayoutItem.Text
• BaseLayoutItem.CustomizationFormText

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

(De)Serialization of layout item captions is disabled in the cases below:

• The StoreText property is set to False.
• The StoreText property is set to Default and all of the following properties are set to false: RestoreLayoutItemText and RestoreLayoutItemCustomizationFormText (the default values of these properties are true). Note that these properties are now hidden at design time; they are left for backward compatibility.

When you create localizable applications that support multiple cultures, disable (de)serialization of layout item captions.