LayoutItemCaptionSettings.AllowWrapCaption Property

OBSOLETE

Use the ChangeCaptionLocationInAdaptiveMode property instead.

Specifies whether caption wrapping is enabled.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v21.2.dll

NuGet Package: DevExpress.Web

Declaration

C#

[DefaultValue(DefaultBoolean.Default)]
[Obsolete("Use the ChangeCaptionLocationInAdaptiveMode property instead.")]
public DefaultBoolean AllowWrapCaption { get; set; }

VB.NET

<Obsolete("Use the ChangeCaptionLocationInAdaptiveMode property instead.")>
<DefaultValue(DefaultBoolean.Default)>
Public Property AllowWrapCaption As DefaultBoolean

Property Value

Type	Default	Description
DefaultBoolean	Default	A DefaultBoolean object.

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:

Library	Object Type	Path to AllowWrapCaption
ASP.NET MVC Extensions	FormLayoutSettings<ModelType>	.SettingsItemCaptions .AllowWrapCaption
ASP.NET Web Forms Controls	ASPxFormLayout	.SettingsItemCaptions .AllowWrapCaption
	FormLayoutProperties	.SettingsItemCaptions .AllowWrapCaption
	LayoutGroupBase	.SettingsItemCaptions .AllowWrapCaption
	LayoutItem	.CaptionSettings .AllowWrapCaption

Remarks

Use the AllowWrapCaption property to specify whether to wrap the Form Layout item’s caption when the control operates in the Adaptive Grid Layout (Breakpoints) mode.

You can specify the width at which the caption wraps using the GridBreakpointSettings.WrapCaptionAtWidth property. If the GridBreakpointSettings.WrapCaptionAtWidth property is not specified, the control doesn’t wrap the caption.

ASPX

<dx:ASPxFormLayout runat="server" ID="ASPxFormLayout" Width="100%" ClientInstanceName="FormLayout">
    <Items>
        <dx:LayoutGroup Width="100%" Caption="Registration Form" ColumnCount="3">
            <GridSettings StretchLastItem="true" WrapCaptionAtWidth="660">
                <Breakpoints>
                    <dx:LayoutBreakpoint MaxWidth="500" ColumnCount="1" Name="S" />
                    <dx:LayoutBreakpoint MaxWidth="800" ColumnCount="2" Name="M" />
                </Breakpoints>
            </GridSettings>
            <Items>
            ...
            </Items>
        </dx:LayoutGroup>
    </Items>
</dx:ASPxFormLayout>

Concept

Adaptivity

Online Demo

Form Layout - Adaptive Grid Layout