BarItem.Visibility Property

Specifies when the item is visible.

Namespace: DevExpress.XtraBars

Assembly: DevExpress.XtraBars.v19.1.dll

Declaration

C#

[DefaultValue(BarItemVisibility.Always)]
[DXCategory("Behavior")]
[XtraSerializableProperty]
public virtual BarItemVisibility Visibility { get; set; }

VB.NET

<DefaultValue(BarItemVisibility.Always)>
<DXCategory("Behavior")>
<XtraSerializableProperty>
Public Overridable Property Visibility As BarItemVisibility

Property Value

Type	Default	Description
BarItemVisibility	**Always**	A BarItemVisibility enumeration value that specifies the visibility of this item.

Available values:

Name	Description
Always	Indicates that associated links are visible regardless of whether the runtime customization is performed.
Never	Indicates that associated links are hidden regardless of whether the runtime customization is performed.
OnlyInCustomizing	Indicates that associated links are only visible when the runtime customization is performed.
OnlyInRuntime	Indicates that associated links are only visible when the runtime customization is not performed.

Remarks

This property specifies the item visibility depending on whether the customization window is open. This property is not in effect at design time.

C#

barButtonItem1.Visibility = DevExpress.XtraBars.BarItemVisibility.Never;

VB.NET

barButtonItem1.Visibility = DevExpress.XtraBars.BarItemVisibility.Never

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Visibility property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-change-a-menu-items-visibility-right-before-a-submenu-is-open-e275/CS/Form1.cs#L17

case 0:
    bbOpenText.Visibility = BarItemVisibility.Always;
    bbOpenImage.Visibility = BarItemVisibility.OnlyInCustomizing;

XAF_how-to-create-information-panels-e2690/CS/InfoPanels.Module.Win/MainForm.cs#L64

if (isMdi) {
    barSubItemWindow.Visibility = BarItemVisibility.Always;
    barMdiChildrenListItem.Visibility = BarItemVisibility.Always;

how-to-implement-a-data-navigator-for-a-ribbonstatusbar-e451/CS/BarsDataNavigator.cs#L308

get {
    return (Button != null && Button.Visibility == BarItemVisibility.Always);
}

how-to-perform-data-navigation-via-toolbar-buttons-e834/CS/DataNavigator/BarsDataNavigator.cs#L453

{
    return (Button != null && Button.Visibility == BarItemVisibility.Always);
}

xtrabars-how-to-change-a-repositoryitem-value-e2855/CS/WindowsApplication1/RibbonForm1.cs#L32

{
    beiProgress.Visibility = (sender as CheckEdit).Checked ? BarItemVisibility.Always : BarItemVisibility.Never;
    return;

VB.NET

how-to-change-a-menu-items-visibility-right-before-a-submenu-is-open-e275/VB/Form1.vb#L19

Case 0
    bbOpenText.Visibility = BarItemVisibility.Always
    bbOpenImage.Visibility = BarItemVisibility.OnlyInCustomizing

XAF_how-to-create-information-panels-e2690/VB/InfoPanels.Module.Win/MainForm.vb#L84

If isMdi Then
    barSubItemWindow.Visibility = BarItemVisibility.Always
    barMdiChildrenListItem.Visibility = BarItemVisibility.Always

how-to-implement-a-data-navigator-for-a-ribbonstatusbar-e451/VB/BarsDataNavigator.vb#L334

Get
    Return (Button IsNot Nothing AndAlso Button.Visibility = BarItemVisibility.Always)
End Get

xtrabars-how-to-change-a-repositoryitem-value-e2855/VB/VB/WindowsApplication1/RibbonForm1.vb#L29

If (TryCast(sender, CheckEdit)).Checked Then
    beiProgress.Visibility = BarItemVisibility.Always
Else

how-to-perform-data-navigation-via-toolbar-buttons-e834/VB/DataNavigator/BarsDataNavigator.vb#L360

Get
    Return (Button IsNot Nothing AndAlso Button.Visibility = BarItemVisibility.Always)
End Get