GridColumn.Visible Property

Gets or sets whether the grid column is visible.

Namespace: DevExpress.XtraGrid.Columns

Assembly: DevExpress.XtraGrid.v20.2.dll

NuGet Package: DevExpress.Win.Grid

Declaration

C#

[DefaultValue(false)]
[DXCategory("Appearance")]
[XtraSerializableProperty]
[XtraSerializablePropertyId(3)]
public virtual bool Visible { get; set; }

VB.NET

<DXCategory("Appearance")>
<DefaultValue(False)>
<XtraSerializableProperty>
<XtraSerializablePropertyId(3)>
Public Overridable Property Visible As Boolean

Property Value

Type	Default	Description
Boolean	**false**	true if the column is visible; otherwise, false.

Remarks

The Visible and GridColumn.VisibleIndex properties specify the column’s visible state and position. When you hide/show the column with the Visible property, the GridColumn.VisibleIndex property automatically reflects the changes. Similarly, if you toggle the column’s visibility with the GridColumn.VisibleIndex property, the Visible property changes automatically. See GridColumn.VisibleIndex to learn more.

The code sample below illustrates how to change grid column visibility based on the user’s permissions.

C#

public class UserPermissions
{
    public bool canSeeProductId;
    public bool canSeeProductActions;
}

UserPermissions permissions = new UserPermissions();
permissions.canSeeProductId = false;
permissions.canSeeProductActions = false;

gridView1.Columns["productId"].Visible = permissions.canSeeProductId;
gridView1.Columns["productActions"].Visible = permissions.canSeeProductActions;

VB.NET

Public Class UserPermissions
    Public canSeeProductId As Boolean
    Public canSeeProductActions As Boolean
End Class

Private permissions As New UserPermissions()
permissions.canSeeProductId = False
permissions.canSeeProductActions = False

gridView1.Columns("productId").Visible = permissions.canSeeProductId
gridView1.Columns("productActions").Visible = permissions.canSeeProductActions

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Visible 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-implement-your-own-serializable-property-for-the-gridcolumn-e1951/CS/Q242361/Grid.cs#L79

public override bool Visible {
    get { return base.Visible; }
    set {

how-to-customize-columns-order-and-visibility-in-a-custom-drop-down-menu-e2015/CS/Sample/CustomGridControl.cs#L83

    col.VisibleIndex = cp.VisibleIndex;
    col.Visible = cp.Visible;
}

how-to-use-typeconverter-for-converting-values-displayed-in-a-gridlookupedit-dropdown-e2814/CS/E2814/WindowsApplication3/TypeConverterHelper.cs#L50

{
    originColumn.Visible = false;
    GridColumn column = view.Columns.AddField(unboundColumnFieldName);

creating-quick-column-customization-popup-window-e991/CS/E991/GridViewQuickColumnCustomization.cs#L145

    GridColumn column = (GridColumn)CheckListBox.Items[i].Value;
    column.Visible = CheckListBox.Items[i].CheckState == CheckState.Checked;
}

capability-for-a-single-column-to-fill-an-empty-space-in-a-grid-view-e2436/CS/FillEmptySpaceGridColumn/Form1.cs#L20

{
    fillGridView1.Columns["HP"].Visible = !fillGridView1.Columns["HP"].Visible;
}

VB.NET

how-to-implement-your-own-serializable-property-for-the-gridcolumn-e1951/VB/Q242361/Grid.vb#L119

Get
    Return MyBase.Visible
End Get

how-to-customize-columns-order-and-visibility-in-a-custom-drop-down-menu-e2015/VB/Sample/CustomGridControl.vb#L99

    col.VisibleIndex = cp.VisibleIndex
    col.Visible = cp.Visible
Next col

how-to-use-typeconverter-for-converting-values-displayed-in-a-gridlookupedit-dropdown-e2814/VB/WindowsApplication3/TypeConverterHelper.vb#L49

If originColumn IsNot Nothing Then
    originColumn.Visible = False
    Dim column As GridColumn = view.Columns.AddField(unboundColumnFieldName)

creating-quick-column-customization-popup-window-e991/VB/E991/GridViewQuickColumnCustomization.vb#L184

    Dim column As GridColumn = CType(CheckListBox.Items(i).Value, GridColumn)
    column.Visible = CheckListBox.Items(i).CheckState = CheckState.Checked
Next i

capability-for-a-single-column-to-fill-an-empty-space-in-a-grid-view-e2436/VB/FillEmptySpaceGridColumn/Form1.vb#L17

Private Sub simpleButton1_Click(ByVal sender As Object, ByVal e As EventArgs) Handles simpleButton1.Click
    fillGridView1.Columns("HP").Visible = Not fillGridView1.Columns("HP").Visible
End Sub