BaseLayoutItem.Visibility Property

Allows you to hide the item from the Layout Control and Customization Form.

Namespace: DevExpress.XtraLayout

Assembly: DevExpress.XtraLayout.v20.1.dll

Declaration

[XtraSerializableProperty]
[DefaultValue(LayoutVisibility.Always)]
[DXCategory("Behavior")]
public LayoutVisibility Visibility { get; set; }
<XtraSerializableProperty>
<DefaultValue(LayoutVisibility.Always)>
<DXCategory("Behavior")>
Public Property Visibility As LayoutVisibility

Property Value

Type Default Description
LayoutVisibility

Always

A LayoutVisibility value that specifies whether the item is visible in the layout and the Customization Form.

Remarks

NOTE

The Layout Control manages the visibility of controls embedded in layout items. Do not use an embedded control's Visible property to specify its visibility. If you wish to hide a layout item or its control, use the item's properties and methods instead.

Hide items to the Customization Form

You can use the context menu and drag-and-drop operations to hide items to - or restore items from - the Customization Form. To change item visibility at runtime, you first need to activate customization mode.

LayoutControl - HideToCustomization

To hide items to (or restore items from) the Customization Form in code, use the BaseLayoutItem.HideToCustomization and BaseLayoutItem.RestoreFromCustomization methods.

When layout items are hidden to the Customization Form, they do not retain their positions in the layout.

Use the LayoutControl.HiddenItems collection to access items hidden to the Customization Form.

Collapse items (Hide items without showing them in the Customization Form)

The Visibility property allows you to hide items and prevent access to them from the Customization Form's Hidden Items tab. These items are not accessible from the LayoutControl.HiddenItems collection either.

A layout item hidden with the Visibility property retains its position within the LayoutControl. This item is collapsed to a one pixel-width transparent line. Two or more adjacent hidden items are collapsed to a two pixel-width transparent line. When a hidden item's visibility is restored, it is displayed at its previous position.

LayoutControl - HideToCustomization

Hide an item's contents

The LayoutControlItem.ContentVisible property specifies the visibility of the item's contents (embedded control, text label, and image). When you hide the item's contents, the item retains its size and position. It is displayed as an empty rectangle.

The following animation shows the difference between the ContentVisible and Visibility properties.

LayoutControl - ContentVisible vs Visibility

See Also