Skip to main content
Tab

LayoutItemCaptionSettings.AllowWrapCaption Property

OBSOLETE

Use the ChangeCaptionLocationInAdaptiveMode property instead.

Specifies whether caption wrapping is enabled.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v24.2.dll

Declaration

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

Property Value

Type Default Description
DefaultBoolean Default

A DefaultBoolean object.

Available values:

Name Description Return Value
True

The value is true.

0

False

The value is false.

1

Default

The value is specified by a global option or a higher-level object.

2

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.

<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

See Also