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.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
  [Expand]DevExpress.XtraGrid.Columns
  [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
  [Collapse]DevExpress.XtraNavBar
   [Expand]Collection Class
   [Expand]CollectionItemEventArgs Class
    CollectionItemEventHandler Delegate
   [Expand]ComponentCollectionItem Class
   [Expand]ICollectionItem Interface
    LinkSelectionModeType Enumeration
   [Expand]NavBarAppearances Class
   [Expand]NavBarCalcGroupClientHeightEventArgs Class
    NavBarCalcGroupClientHeightEventHandler Delegate
   [Expand]NavBarCalcHintSizeEventArgs Class
    NavBarCalcHintSizeEventHandler Delegate
   [Collapse]NavBarControl Class
     NavBarControl Members
     NavBarControl Constructor
    [Collapse]NavBarControl Properties
      ActiveGroup Property
      ActiveGroupName Property
      AllowDrop Property
      AllowGlyphSkinning Property
      AllowHorizontalResizing Property
      AllowHtmlString Property
      AllowSelectedLink Property
      Appearance Property
      AvailableNavBarViews Property
      BackgroundImage Property
      BackgroundImageLayout Property
      BorderStyle Property
      ContentButtonHint Property
      Cursor Property
      DragDropFlags Property
      EachGroupHasSelectedLink Property
      ExplorerBarGroupInterval Property
      ExplorerBarGroupOuterIndent Property
      ExplorerBarShowGroupButtons Property
      ExplorerBarStretchLastGroup Property
      FireDelayedSelectedLinkChangedEvent Property
      GroupBackgroundImage Property
      Groups Property
      GroupTextureBackgroundBrush Property
      HideGroupCaptions Property
      HotTrackedGroup Property
      HotTrackedGroupCursor Property
      HotTrackedItemCursor Property
      HotTrackedLink Property
      HtmlImages Property
      IsDesignMode Property
      IsLoading Property
      Items Property
      LargeImages Property
      LayoutVersion Property
      LinkInterval Property
      LinkSelectionMode Property
      LookAndFeel Property
      MenuManager Property
      MinimumSize Property
      NavigationPaneGroupClientHeight Property
      NavigationPaneMaxVisibleGroups Property
      NavigationPaneOverflowPanelUseSmallImages Property
      NavPaneForm Property
      OptionsLayout Property
      OptionsNavPane Property
      PaintAppearance Property
      PaintStyleKind Property
      PaintStyleName Property
      PressedGroup Property
      PressedLink Property
      ScaleImages Property
      ScrollMode Property
      SelectedLink Property
      SelectLinkOnPress Property
      SharedImageCollectionImageSizeMode Property
      ShowGroupHint Property
      ShowHintInterval Property
      ShowIcons Property
      ShowLinkHint Property
      SkinExplorerBarViewScrollStyle Property
      SmallImages Property
      State Property
      StoreDefaultPaintStyleName Property
      SuspendFormLayoutInAnimation Property
      TabStop Property
      ToolTipController Property
      View Property
      ViewName Property
    [Expand]NavBarControl Events
    [Expand]NavBarControl Methods
   [Expand]NavBarCustomDrawHintEventArgs Class
    NavBarCustomDrawHintEventHandler Delegate
   [Expand]NavBarCustomHintEventArgs Class
    NavBarDragDrop Enumeration
   [Expand]NavBarGetHintEventArgs Class
    NavBarGetHintEventHandler Delegate
   [Expand]NavBarGroup Class
   [Expand]NavBarGroupControlContainer Class
   [Expand]NavBarGroupEventArgs Class
    NavBarGroupEventHandler Delegate
    NavBarGroupStyle Enumeration
   [Expand]NavBarHitInfo Class
    NavBarHitTest Enumeration
    NavBarImage Enumeration
   [Expand]NavBarItem Class
   [Expand]NavBarItemLink Class
   [Expand]NavBarLayoutOptions Class
   [Expand]NavBarLinkEventArgs Class
    NavBarLinkEventHandler Delegate
    NavBarState Enumeration
    NavBarStringId Enumeration
    NavBarViewKind Enumeration
   [Expand]NavElement Class
   [Expand]NavGroupCollection Class
   [Expand]NavItemCollection Class
   [Expand]NavLinkCollection Class
    NavPaneState Enumeration
   [Expand]NavReadOnlyLinkCollection Class
   [Expand]OptionsNavPane Class
    SkinExplorerBarViewScrollStyle Enumeration
  [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]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]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

NavBarControl.GroupBackgroundImage Property

Specifies the image displayed as a background for groups.

Namespace:DevExpress.XtraNavBar
Assembly:DevExpress.XtraNavBar.v17.1.dll

Expanded Syntax

Property value

Type: Image
A System.Drawing.Image object specifying the image to be displayed for a group's background.
The default is null.

Expanded Remarks

Each group can provide its own background image. Use the NavBarGroup.BackgroundImage property for this purpose. You can obtain the desired NavBarGroup object via the Groups property.

Groups must have transparent background colors in order to make their background images visible. To specify a transparent background color for a group, use the control's Appearance.GroupBackGround.BackColor or the group's AppearanceBackground.BackColor property.

Note

Background images are not supported in skinning paint schemes. Use the LookAndFeel property to specify a paint scheme.

Expanded Example

The following sample code assigns background images to the XtraNavBar and its groups. The NavBarGroup.BackgroundImage and GroupBackgroundImage properties are used for this purpose. The BeginUpdate and EndUpdate methods are used to avoid repeated redrawing when changes are implemented.

The image below shows the nav bar before and after the code below has been executed.

Expanded See Also

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