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
  [Collapse]DevExpress.Utils
   [Collapse]AppearanceObject Class
     AppearanceObject Members
    [Expand]AppearanceObject Constructor
    [Expand]AppearanceObject Properties
    [Expand]AppearanceObject Events
    [Collapse]AppearanceObject Methods
     [Expand]Assign Method
      AssignInternal Method
      BeginUpdate Method
     [Expand]CalcDefaultTextSize Method
     [Expand]CalcTextSize Method
     [Expand]CalcTextSizeInt Method
      CancelUpdate Method
      Clone Method
      Combine Method
      Dispose Method
     [Expand]DrawBackground Method
     [Expand]DrawString Method
      DrawVString Method
      EndUpdate Method
     [Expand]FillRectangle Method
      GetAppearanceByFont Method
      GetAppearanceByOption Method
     [Collapse]GetBackBrush Method
       GetBackBrush(GraphicsCache) Method
       GetBackBrush(GraphicsCache, Rectangle) Method
      GetBackColor Method
      GetBackColor2 Method
      GetBackPen Method
      GetBorderBrush Method
      GetBorderColor Method
      GetBorderPen Method
      GetFont Method
      GetFontHeight Method
      GetForeBrush Method
      GetForeColor Method
      GetForePen Method
      GetGradientMode Method
      GetImage Method
     [Expand]GetStringFormat Method
      GetTextOptions Method
      GetTextureBrush Method
      IsEqual Method
      Reset Method
      ShouldSerialize Method
      ToString Method
   [Expand]AppearanceObjectEx Class
   [Expand]AppearanceOptions Class
   [Expand]AppearanceOptionsEx Class
   [Expand]BaseAppearanceCollection Class
   [Expand]CheckContextButton Class
   [Expand]ContextButton Class
   [Expand]ContextButtonBase Class
   [Expand]ContextItem Class
   [Expand]DefaultToolTipController Class
   [Expand]DPIAwareImageCollection Class
   [Expand]DXMouseEventArgs Class
    EditorShowMode Enumeration
   [Expand]FlyoutPanel Class
   [Expand]FlyoutPanelButtonOptions Class
   [Expand]FlyoutPanelOptions Class
    GroupElementLocation Enumeration
   [Expand]HideException Class
    HKeyPrefix Enumeration
   [Expand]ImageCollection Class
   [Expand]Images Class
   [Expand]KeyShortcut Class
    Locations Enumeration
   [Expand]MagnifierDialog Class
   [Expand]MagnifierDialogArgs Class
   [Expand]MagnifierDialogResult Structure
   [Expand]RatingContextButton Class
   [Expand]SharedImageCollection Class
    SharedImageCollectionImageSizeMode Enumeration
   [Expand]SuperToolTip Class
   [Expand]SvgImageCollection Class
   [Expand]TextOptions Class
   [Expand]ThumbnailImageEventArgs Class
   [Expand]ToolTipControlInfo Class
   [Expand]ToolTipController Class
    ToolTipControllerBeforeShowEventHandler Delegate
   [Expand]ToolTipControllerCalcSizeEventArgs Class
    ToolTipControllerCalcSizeEventHandler Delegate
   [Expand]ToolTipControllerCustomDrawEventArgs Class
    ToolTipControllerCustomDrawEventHandler Delegate
   [Expand]ToolTipControllerEventArgsBase Class
   [Expand]ToolTipControllerGetActiveObjectInfoEventArgs Class
    ToolTipControllerGetActiveObjectInfoEventHandler Delegate
   [Expand]ToolTipControllerShowEventArgs Class
    ToolTipIconSize Enumeration
    ToolTipIconType Enumeration
   [Expand]ToolTipItem Class
    ToolTipLocation Enumeration
    ToolTipStyle Enumeration
    ToolTipType Enumeration
   [Expand]TrackBarContextButton Class
    Trimming Enumeration
   [Expand]WorkspaceManager Class
    XPThemeSupport Enumeration
  [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
  [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

AppearanceObject.GetBackBrush(GraphicsCache, Rectangle) Method

Gets the brush used to draw an element's background.

Namespace:DevExpress.Utils
Assembly:DevExpress.Utils.v17.2.dll

Expanded Syntax

Parameters

cache
Type: GraphicsCache
A GraphicsCache object that provides access to the pens and brushes used for painting.
rect
Type: Rectangle
A System.Drawing.Rectangle structure specifying the rectangle for which a brush is created.

Return value

Type: Brush
A System.Drawing.Brush descendant representing the brush specified by the appearance object's settings.

Expanded Remarks

If the end color of the gradient's background brush is Color.Empty or is equal to the starting color, the GetBackBrush method returns a solid brush whose color is specified by the background color settings of the current appearance object. Otherwise, this method returns a linear gradient brush.

If the cache parameter's value is not a null reference, the GetBackBrush method uses the GraphicsCache object to obtain the brush. This allows you to obtain the brush more quickly, since it may already be stored within the cache. Otherwise, a new System.Drawing.Brush descendant with appropriate settings is created and returned.

Use the GetBackColor and GetBackColor2 methods to obtain the starting and ending background colors specified by the appearance object's settings.

Expanded See Also

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