Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Expand]Controls and Libraries
 [Expand]Common Features
  Get More Help
 [Collapse]API Reference
  [Expand]DevExpress.DataAccess.UI.Design
  [Expand]DevExpress.DataAccess.UI.EntityFramework
  [Expand]DevExpress.DataAccess.UI.Excel
  [Expand]DevExpress.DataAccess.UI.Localization
  [Expand]DevExpress.DataAccess.UI.ObjectBinding
  [Expand]DevExpress.DataAccess.UI.Sql
  [Expand]DevExpress.DataAccess.UI.Wizard
  [Expand]DevExpress.DataAccess.UI.Wizard.Services
  [Expand]DevExpress.DataAccess.UI.Wizard.Views
  [Expand]DevExpress.DocumentView
  [Expand]DevExpress.DocumentView.Controls
  [Expand]DevExpress.LookAndFeel
  [Expand]DevExpress.LookAndFeel.Helpers
  [Expand]DevExpress.Skins
  [Expand]DevExpress.Snap
  [Expand]DevExpress.Snap.API.Native
  [Expand]DevExpress.Snap.Core
  [Expand]DevExpress.Snap.Core.API
  [Expand]DevExpress.Snap.Core.Fields
  [Expand]DevExpress.Snap.Core.Forms
  [Expand]DevExpress.Snap.Core.Options
  [Expand]DevExpress.Snap.Core.Services
  [Expand]DevExpress.Snap.Extensions
  [Expand]DevExpress.Snap.Extensions.Localization
  [Expand]DevExpress.Snap.Extensions.UI
  [Expand]DevExpress.Snap.Localization
  [Expand]DevExpress.Snap.Options
  [Expand]DevExpress.Snap.Services
  [Expand]DevExpress.Utils
  [Expand]DevExpress.Utils.Animation
  [Expand]DevExpress.Utils.Controls
  [Expand]DevExpress.Utils.Drawing
  [Expand]DevExpress.Utils.Menu
  [Expand]DevExpress.Utils.Taskbar
  [Expand]DevExpress.Utils.Taskbar.Core
  [Expand]DevExpress.Utils.UI.Localization
  [Expand]DevExpress.Utils.VisualEffects
  [Expand]DevExpress.Utils.Win
  [Expand]DevExpress.XtraBars
  [Expand]DevExpress.XtraBars.Alerter
  [Expand]DevExpress.XtraBars.Docking
  [Expand]DevExpress.XtraBars.Docking2010
  [Expand]DevExpress.XtraBars.Docking2010.Customization
  [Expand]DevExpress.XtraBars.Docking2010.Views
  [Expand]DevExpress.XtraBars.Docking2010.Views.NativeMdi
  [Expand]DevExpress.XtraBars.Docking2010.Views.Tabbed
  [Expand]DevExpress.XtraBars.Docking2010.Views.Widget
  [Expand]DevExpress.XtraBars.Docking2010.Views.WindowsUI
  [Expand]DevExpress.XtraBars.Localization
  [Expand]DevExpress.XtraBars.Navigation
  [Expand]DevExpress.XtraBars.Ribbon
  [Expand]DevExpress.XtraBars.Ribbon.Gallery
  [Expand]DevExpress.XtraBars.Ribbon.ViewInfo
  [Expand]DevExpress.XtraBars.ToastNotifications
  [Expand]DevExpress.XtraBars.Utils
  [Expand]DevExpress.XtraBars.WinRTLiveTiles
  [Expand]DevExpress.XtraCharts
  [Expand]DevExpress.XtraCharts.Designer
  [Expand]DevExpress.XtraCharts.Wizard
  [Expand]DevExpress.XtraDataLayout
  [Expand]DevExpress.XtraDiagram
  [Expand]DevExpress.XtraDiagram.Options
  [Expand]DevExpress.XtraEditors
  [Expand]DevExpress.XtraEditors.ButtonPanel
  [Expand]DevExpress.XtraEditors.Calendar
  [Expand]DevExpress.XtraEditors.Camera
  [Expand]DevExpress.XtraEditors.Container
  [Expand]DevExpress.XtraEditors.Controls
  [Expand]DevExpress.XtraEditors.CustomEditor
  [Expand]DevExpress.XtraEditors.DXErrorProvider
  [Expand]DevExpress.XtraEditors.Filtering
  [Expand]DevExpress.XtraEditors.Mask
  [Expand]DevExpress.XtraEditors.Persistent
  [Expand]DevExpress.XtraEditors.Repository
  [Expand]DevExpress.XtraEditors.ViewInfo
  [Expand]DevExpress.XtraFilterEditor
  [Expand]DevExpress.XtraGauges.Presets.Styles
  [Expand]DevExpress.XtraGauges.Win
  [Expand]DevExpress.XtraGauges.Win.Base
  [Expand]DevExpress.XtraGauges.Win.Gauges.Circular
  [Expand]DevExpress.XtraGauges.Win.Gauges.Digital
  [Expand]DevExpress.XtraGauges.Win.Gauges.Linear
  [Expand]DevExpress.XtraGauges.Win.Gauges.State
  [Expand]DevExpress.XtraGrid
  [Collapse]DevExpress.XtraGrid.Columns
    AutoFilterCondition Enumeration
   [Expand]ColumnFilterInfo Class
    ColumnFilterType Enumeration
    FilterPopupMode Enumeration
    FixedStyle Enumeration
   [Collapse]GridColumn Class
     GridColumn Members
     GridColumn Constructor
    [Collapse]GridColumn Properties
      AbsoluteIndex Property
      AllowSummaryMenu Property
      AppearanceCell Property
      AppearanceHeader Property
      CanShowInCustomizationForm Property
      Caption Property
      ColumnAnnotationAttributes Property
      ColumnEdit Property
      ColumnEditName Property
      ColumnHandle Property
      ColumnType Property
      CustomizationCaption Property
      CustomizationSearchCaption Property
      DisplayFormat Property
      FieldName Property
      FieldNameSortGroup Property
      FilterInfo Property
      FilterMode Property
      Fixed Property
      GroupFormat Property
      GroupIndex Property
      GroupInterval Property
      Image Property
      ImageAlignment Property
      ImageIndex Property
      ImageOptions Property
      Images Property
      IsLoading Property
      IsUnboundExpressionValid Property
      MaxWidth Property
      MinWidth Property
      MRUFilters Property
      Name Property
      OptionsColumn Property
      OptionsEditForm Property
      OptionsFilter Property
      ReadOnly Property
      RealColumnEdit Property
      ShowButtonMode Property
      ShowUnboundExpressionMenu Property
      SortIndex Property
      SortMode Property
      SortOrder Property
      Summary Property
      SummaryItem Property
      SummaryText Property
      Tag Property
      ToolTip Property
      UnboundExpression Property
      UnboundType Property
      View Property
      Visible Property
      VisibleIndex Property
      VisibleWidth Property
      Width Property
    [Expand]GridColumn Methods
   [Expand]GridColumnCollection Class
   [Expand]GridColumnReadOnlyCollection Class
   [Expand]GridColumnSortInfo Class
   [Expand]GridColumnSortInfoCollection Class
   [Expand]GroupSummarySortInfo Class
   [Expand]GroupSummarySortInfoCollection Class
   [Expand]LayoutViewColumn Class
   [Expand]LayoutViewColumnCollection Class
   [Expand]OptionsColumn Class
   [Expand]OptionsColumnEditForm Class
   [Expand]OptionsColumnFilter Class
   [Expand]TileViewColumns Class
  [Expand]DevExpress.XtraGrid.EditForm
  [Expand]DevExpress.XtraGrid.FilterEditor
  [Expand]DevExpress.XtraGrid.Localization
  [Expand]DevExpress.XtraGrid.Views.BandedGrid
  [Expand]DevExpress.XtraGrid.Views.BandedGrid.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Base
  [Expand]DevExpress.XtraGrid.Views.Base.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Card
  [Expand]DevExpress.XtraGrid.Views.Card.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Grid
  [Expand]DevExpress.XtraGrid.Views.Grid.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Layout
  [Expand]DevExpress.XtraGrid.Views.Layout.Events
  [Expand]DevExpress.XtraGrid.Views.Layout.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Printing
  [Expand]DevExpress.XtraGrid.Views.Tile
  [Expand]DevExpress.XtraGrid.Views.WinExplorer
  [Expand]DevExpress.XtraGrid.WinExplorer
  [Expand]DevExpress.XtraLayout
  [Expand]DevExpress.XtraLayout.Customization
  [Expand]DevExpress.XtraLayout.HitInfo
  [Expand]DevExpress.XtraLayout.Localization
  [Expand]DevExpress.XtraLayout.Utils
  [Expand]DevExpress.XtraMap
  [Expand]DevExpress.XtraMap.Printing
  [Expand]DevExpress.XtraNavBar
  [Expand]DevExpress.XtraNavBar.ViewInfo
  [Expand]DevExpress.XtraPdfViewer
  [Expand]DevExpress.XtraPdfViewer.Commands
  [Expand]DevExpress.XtraPdfViewer.Localization
  [Expand]DevExpress.XtraPivotGrid
  [Expand]DevExpress.XtraPivotGrid.Data
  [Expand]DevExpress.XtraPrinting
  [Expand]DevExpress.XtraPrinting.Control
  [Expand]DevExpress.XtraPrinting.Preview
  [Expand]DevExpress.XtraPrintingLinks
  [Expand]DevExpress.XtraReports.UI
  [Expand]DevExpress.XtraRichEdit
  [Expand]DevExpress.XtraRichEdit.Commands
  [Expand]DevExpress.XtraRichEdit.Export
  [Expand]DevExpress.XtraRichEdit.Import
  [Expand]DevExpress.XtraRichEdit.Localization
  [Expand]DevExpress.XtraRichEdit.Menu
  [Expand]DevExpress.XtraScheduler
  [Expand]DevExpress.XtraScheduler.Drawing
  [Expand]DevExpress.XtraScheduler.Printing
  [Expand]DevExpress.XtraScheduler.Reporting
  [Expand]DevExpress.XtraScheduler.Reporting.UI
  [Expand]DevExpress.XtraScheduler.Services
  [Expand]DevExpress.XtraScheduler.Services.Implementation
  [Expand]DevExpress.XtraScheduler.UI
  [Expand]DevExpress.XtraSpellChecker
  [Expand]DevExpress.XtraSpellChecker.Localization
  [Expand]DevExpress.XtraSplashForm
  [Expand]DevExpress.XtraSplashScreen
  [Expand]DevExpress.XtraSpreadsheet
  [Expand]DevExpress.XtraSpreadsheet.Services
  [Expand]DevExpress.XtraTab
  [Expand]DevExpress.XtraTab.Buttons
  [Expand]DevExpress.XtraTab.ViewInfo
  [Expand]DevExpress.XtraTabbedMdi
  [Expand]DevExpress.XtraToolbox
  [Expand]DevExpress.XtraTreeList
  [Expand]DevExpress.XtraTreeList.Columns
  [Expand]DevExpress.XtraTreeList.Data
  [Expand]DevExpress.XtraTreeList.Localization
  [Expand]DevExpress.XtraTreeList.Menu
  [Expand]DevExpress.XtraTreeList.Nodes
  [Expand]DevExpress.XtraTreeList.Nodes.Operations
  [Expand]DevExpress.XtraTreeList.StyleFormatConditions
  [Expand]DevExpress.XtraTreeMap
  [Expand]DevExpress.XtraVerticalGrid
  [Expand]DevExpress.XtraVerticalGrid.Events
  [Expand]DevExpress.XtraVerticalGrid.Localization
  [Expand]DevExpress.XtraVerticalGrid.Rows
  [Expand]DevExpress.XtraWaitForm
  [Expand]DevExpress.XtraWizard
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

GridColumn.VisibleIndex Property

Gets or sets the column's visible state and position within the View.

Namespace:DevExpress.XtraGrid.Columns
Assembly:DevExpress.XtraGrid.v17.2.dll

Expanded Syntax

Property value

Type: Int32
An integer value specifying the column's visible state and position within the View. -1 if the column is either a grouping column or hidden.
The default is -1.

Expanded Remarks

To iterate through and access visible columns (columns displaying their values within grid cells), use the ColumnView.VisibleColumns collection. When data is grouped, you may not get the same results if you iterate through the ColumnView.Columns collection and access only columns whose VisibleIndex >= 0. There may be multiple columns with the same VisibleIndex. This happens when you group by a column, provided that the GridOptionsView.ShowGroupedColumns setting is disabled. This column's VisibleIndex is not reset to -1 in this case. To check whether a column is a grouping column, use the GroupIndex property.

If a column's VisibleIndex property is set to -1, either this column is hidden and accessible via the Customization Form, or this column is a grouping column. Check the column's GroupIndex property to see if this column is a grouping column.

To hide a specific column, you can use one of the following methods:
  • set the VisibleIndex and GroupIndex properties to -1.
  • set the Visible property to false.

For visible columns, the VisibleIndex property specifies the zero-based visual position among other visible columns. You can change the VisibleIndex property to move a column to a specific position. Setting this property for grouped columns to a non-negative value has no effect unless the GridOptionsView.ShowGroupedColumns option is true.

The VisibleIndex property cannot be set to a value less than -1, or greater than the number of currently visible columns. When assigning a value outside of these bounds, the value is automatically set to either -1 or the last available index.

When you move a column forward (i.e., assign a new visible index that is higher than the current visible index), the current column is moved to the position before the column whose VisibleIndex equals the assigned value. So, the actual visible index will be the assigned value minus one. When you move a column backward (i.e., assign a new visible index that is lower than the current visible index), the current column is moved to the position specified by the assigned value. The actual visible index will match the assigned value.

Note how the VisibleIndex property is treated while you are adding a new column to the View. If you set the new column's VisibleIndex property before adding it to the View and if the View already contains another column with the same visible index, the new column will be added after the existing column. To add a column at a specific position among visible columns, you can set the column's VisibleIndex property after the column is added to the View.

The VisibleIndex property is overridden by the BandedGridColumn class. Banded Views provide other means of rearranging columns.

When a column's position is changed, the ColumnView.ColumnPositionChanged event fires.

Expanded See Also

How would you rate this topic?​​​​​​​