[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand].NET Core 3 Support
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Expand]Controls and Libraries
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Collapse]API Reference
  [Expand]DevExpress.Charts.Designer
  [Expand]DevExpress.Data
  [Expand]DevExpress.Mvvm.UI
  [Expand]DevExpress.Mvvm.UI.Interactivity
  [Expand]DevExpress.Mvvm.UI.ModuleInjection
  [Expand]DevExpress.Xpf.Accordion
  [Expand]DevExpress.Xpf.Bars
  [Expand]DevExpress.Xpf.Carousel
  [Expand]DevExpress.Xpf.Charts
  [Expand]DevExpress.Xpf.Charts.Localization
  [Expand]DevExpress.Xpf.Charts.RangeControlClient
  [Expand]DevExpress.Xpf.ChunkList
  [Expand]DevExpress.Xpf.Controls
  [Collapse]DevExpress.Xpf.Core
   [Collapse]Badge Class
     Badge Members
     Badge Constructor
    [Expand]Badge Properties
    [Expand]Badge Events
    [Expand]Badge Methods
    BadgeKind Enumeration
    BadgeShape Enumeration
   [Expand]BaseSvgImageSourceExtension Class
    BestFitMode Enumeration
    BorderEffect Enumeration
    ButtonShowMode Enumeration
   [Expand]CancelRoutedEventArgs Class
    CancelRoutedEventHandler Delegate
   [Expand]ColumnChooserControlBase Class
   [Expand]CompleteRecordDragDropEventArgs Class
   [Expand]ContentHost Class
   [Expand]ContinueRecordDragEventArgs Class
    ControlBoxButtons Enumeration
   [Expand]DataObjectBase Class
   [Expand]DialogService Class
   [Expand]DragDropHintData Class
   [Expand]DragEventArgsBase Class
   [Expand]DragRecordOverEventArgs Class
   [Expand]DropDownButton Class
   [Expand]DropDownButtonBase Class
   [Expand]DropMarkerData Class
    DropPlace Enumeration
    DropPosition Enumeration
   [Expand]DropRecordEventArgs Class
   [Expand]DXDialog Class
   [Expand]DXDialogWindow Class
   [Expand]DXExpander Class
   [Expand]DXFrameworkContentElement Class
   [Expand]DXImageHelper Class
   [Expand]DXLocalizer<T> Class
   [Expand]DXMessageBox Class
   [Expand]DXMessageBoxService Class
   [Expand]DXSplashScreenService Class
   [Expand]DXTabbedWindow Class
   [Expand]DXTabControl Class
   [Expand]DXTabItem Class
   [Expand]DXWindow Class
    EditorShowMode Enumeration
   [Expand]ExpandCollapseInfoEventArgs Class
    ExpandCollapseInfoEventHandler Delegate
   [Expand]FloatingContainer Class
    FloatingMode Enumeration
   [Expand]GiveRecordDragFeedbackEventArgs Class
    HeaderLocation Enumeration
    HeaderOrientation Enumeration
    HideButtonShowMode Enumeration
    HorizontalExpandMode Enumeration
   [Expand]IColumnChooser Interface
   [Expand]IColumnChooserFactory Interface
   [Expand]INotifyIconService Interface
   [Expand]IWorkspace Interface
   [Expand]IWorkspaceManager Interface
   [Expand]ListBoxDragDropBehavior Class
   [Expand]LoadingDecorator Class
    NewButtonShowMode Enumeration
   [Expand]NotifyIconService Class
   [Expand]NotifyIconState Class
   [Expand]PixelSnapper Class
   [Expand]PredefinedThemePalette Class
   [Expand]PredefinedThemePalettes Class
   [Expand]RecordDragDropData Class
    ScrollBarMode Enumeration
    ScrollBars Enumeration
    ScrollButtonShowMode Enumeration
   [Expand]ScrollControl Class
   [Expand]SimpleButton Class
    SingleTabItemHideMode Enumeration
    SplashScreenLocation Enumeration
    SplashScreenLock Enumeration
    SplashScreenOwnerSearchMode Enumeration
   [Expand]SplitButton Class
   [Expand]StartRecordDragEventArgs Class
   [Expand]SuperTip Class
   [Expand]SuperTipHeaderItem Class
   [Expand]SuperTipItem Class
   [Expand]SuperTipItemBase Class
   [Expand]SuperTipItemSeparator Class
   [Expand]SvgImageHelper Class
   [Expand]SvgImageSourceExtension Class
   [Expand]TabbedWindowDocumentUIService Class
    TabbedWindowMode Enumeration
    TabContentCacheMode Enumeration
   [Expand]TabControlCommonCancelEventArgsBase Class
    TabControlDragDropMode Enumeration
   [Expand]TabControlMultiLineView Class
   [Expand]TabControlNewTabbedWindowEventArgs Class
    TabControlNewTabbedWindowEventHandler Delegate
   [Expand]TabControlScrollView Class
   [Expand]TabControlSelectionChangedEventArgs Class
    TabControlSelectionChangedEventHandler Delegate
   [Expand]TabControlSelectionChangingEventArgs Class
    TabControlSelectionChangingEventHandler Delegate
   [Expand]TabControlStretchView Class
   [Expand]TabControlTabAddedEventArgs Class
    TabControlTabAddedEventHandler Delegate
   [Expand]TabControlTabAddingEventArgs Class
    TabControlTabAddingEventHandler Delegate
   [Expand]TabControlTabHiddenEventArgs Class
    TabControlTabHiddenEventHandler Delegate
   [Expand]TabControlTabHidingEventArgs Class
    TabControlTabHidingEventHandler Delegate
   [Expand]TabControlTabRemovedEventArgs Class
    TabControlTabRemovedEventHandler Delegate
   [Expand]TabControlTabRemovingEventArgs Class
    TabControlTabRemovingEventHandler Delegate
   [Expand]TabControlTabShowingEventArgs Class
    TabControlTabShowingEventHandler Delegate
   [Expand]TabControlTabShownEventArgs Class
    TabControlTabShownEventHandler Delegate
   [Expand]TabControlTabStartDraggingEventArgs Class
   [Expand]TabControlViewBase Class
   [Expand]Theme Class
   [Expand]ThemedMessageBox Class
   [Expand]ThemedWindow Class
   [Expand]ThemedWindowDialogButton Class
   [Expand]ThemedWindowHeaderItemsControl Class
   [Expand]ThemedWindowHeaderItemsControlBase Class
   [Expand]ThemedWindowToolbarItemsControl Class
   [Expand]ThemeManager Class
   [Expand]ThemePalette Class
   [Expand]ThemePaletteBase Class
    TransitionEffect Enumeration
   [Expand]UniformStackPanel Class
    VerticalExpandMode Enumeration
   [Expand]WindowedDocumentUIService Class
    WindowKind Enumeration
    WindowTitleAlignment Enumeration
   [Expand]WorkspaceManager Class
   [Expand]WpfSvgPalette Class
  [Expand]DevExpress.Xpf.Core.ConditionalFormatting
  [Expand]DevExpress.Xpf.Core.DataSources
  [Expand]DevExpress.Xpf.Core.FilteringUI
  [Expand]DevExpress.Xpf.Core.Native
  [Expand]DevExpress.Xpf.Core.ServerMode
  [Expand]DevExpress.Xpf.Data
  [Expand]DevExpress.Xpf.DataAccess
  [Expand]DevExpress.Xpf.DataAccess.DataSourceWizard
  [Expand]DevExpress.Xpf.Diagram
  [Expand]DevExpress.Xpf.Dialogs
  [Expand]DevExpress.Xpf.Docking
  [Expand]DevExpress.Xpf.Docking.Base
  [Expand]DevExpress.Xpf.DocumentViewer
  [Expand]DevExpress.Xpf.DXBinding
  [Expand]DevExpress.Xpf.Editors
  [Expand]DevExpress.Xpf.Editors.DataPager
  [Expand]DevExpress.Xpf.Editors.DateNavigator
  [Expand]DevExpress.Xpf.Editors.ExpressionEditor
  [Expand]DevExpress.Xpf.Editors.ExpressionEditor.Native
  [Expand]DevExpress.Xpf.Editors.Filtering
  [Expand]DevExpress.Xpf.Editors.Flyout
  [Expand]DevExpress.Xpf.Editors.Flyout.Native
  [Expand]DevExpress.Xpf.Editors.Helpers
  [Expand]DevExpress.Xpf.Editors.Native
  [Expand]DevExpress.Xpf.Editors.Popups
  [Expand]DevExpress.Xpf.Editors.RangeControl
  [Expand]DevExpress.Xpf.Editors.Settings
  [Expand]DevExpress.Xpf.Editors.Validation
  [Expand]DevExpress.Xpf.ExpressionEditor
  [Expand]DevExpress.Xpf.Gantt
  [Expand]DevExpress.Xpf.Gauges
  [Expand]DevExpress.Xpf.Gauges.Localization
  [Expand]DevExpress.Xpf.Grid
  [Expand]DevExpress.Xpf.Grid.ConditionalFormatting
  [Expand]DevExpress.Xpf.Grid.LookUp
  [Expand]DevExpress.Xpf.Grid.TreeList
  [Expand]DevExpress.Xpf.Layout.Core
  [Expand]DevExpress.Xpf.LayoutControl
  [Expand]DevExpress.Xpf.Map
  [Expand]DevExpress.Xpf.NavBar
  [Expand]DevExpress.Xpf.Navigation
  [Expand]DevExpress.Xpf.PdfViewer
  [Expand]DevExpress.Xpf.PivotGrid
  [Expand]DevExpress.Xpf.PivotGrid.Printing
  [Expand]DevExpress.Xpf.Printing
  [Expand]DevExpress.Xpf.Printing.Parameters
  [Expand]DevExpress.Xpf.Printing.Parameters.Models
  [Expand]DevExpress.Xpf.Printing.PreviewControl
  [Expand]DevExpress.Xpf.Printing.PreviewControl.Bars
  [Expand]DevExpress.Xpf.Prism
  [Expand]DevExpress.Xpf.PropertyGrid
  [Expand]DevExpress.Xpf.Reports.UserDesigner
  [Expand]DevExpress.Xpf.Reports.UserDesigner.Extensions
  [Expand]DevExpress.Xpf.Reports.UserDesigner.Localization
  [Expand]DevExpress.Xpf.Reports.UserDesigner.ReportWizard
  [Expand]DevExpress.Xpf.Reports.UserDesigner.ReportWizard.Pages
  [Expand]DevExpress.Xpf.Ribbon
  [Expand]DevExpress.Xpf.RichEdit
  [Expand]DevExpress.Xpf.RichEdit.Menu
  [Expand]DevExpress.Xpf.Scheduler
  [Expand]DevExpress.Xpf.Scheduler.Drawing
  [Expand]DevExpress.Xpf.Scheduler.Menu
  [Expand]DevExpress.Xpf.Scheduler.Reporting
  [Expand]DevExpress.Xpf.Scheduler.UI
  [Expand]DevExpress.Xpf.Scheduling
  [Expand]DevExpress.Xpf.Scheduling.Common
  [Expand]DevExpress.Xpf.Scheduling.Editors
  [Expand]DevExpress.Xpf.Scheduling.iCalendar
  [Expand]DevExpress.Xpf.Scheduling.Reporting
  [Expand]DevExpress.Xpf.Scheduling.Visual
  [Expand]DevExpress.Xpf.Scheduling.VisualData
  [Expand]DevExpress.Xpf.SpellChecker
  [Expand]DevExpress.Xpf.Spreadsheet
  [Expand]DevExpress.Xpf.Spreadsheet.Menu
  [Expand]DevExpress.Xpf.TreeMap
  [Expand]DevExpress.Xpf.Utils.Themes
  [Expand]DevExpress.Xpf.WindowsUI
  [Expand]DevExpress.Xpf.WindowsUI.Internal
  [Expand]DevExpress.Xpf.WindowsUI.Navigation
  [Expand]DevExpress.XtraRichEdit
  [Expand]DevExpress.XtraRichEdit.Printing
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Badge Class

The Badge control displays a text in a badge over a visual element.

Namespace:DevExpress.Xpf.Core
Assembly:DevExpress.Xpf.Core.v19.2.dll

Expanded Syntax

Expanded Remarks

Set the Badge attached property on a visual element to display a Badge control over the element:

Expanded Custom Content Formats

The ContentStringFormat and ContentFormatProvider properties allow you to format the Badge's content. For example, you can display '99+' instead of numbers equal to or greater than 100:

Refer to the ContentStringFormat or ContentFormatProvider property descriptions for a code sample.

Expanded Customize the Appearance

Size

You can change a Badge size with the following properties:

Position

You can use two sets of properties to specify the Badge control's position:

Shapes

Predefined Shapes

Use the BadgeShape property to choose one of a Badge control's shapes:

Value Name Figure
BadgeShape.Pill
BadgeShape.Rectangle
BadgeShape.RoundedRectangle

Custom Shapes

You can specify the CornerRadius property. When its value is not Null, the Badge control ignores the BadgeShape property.

The following code sample sets the radius of the Badge control's top-left/top-right/bottom-right corners to 5 and the bottom-left corner to 0:

Colors

Predefined Colors

Use the BadgeKind property to choose one of a predefined Badge colors:

Value Name Figure
BadgeKind.Error
BadgeKind.Information
BadgeKind.None
BadgeKind.Success
BadgeKind.Warning
Note

The Badge control's predefined colors depend on the application theme.

Custom Colors

You can change a Badge color with the following properties:

The following code sample shows how to get the Badge control's colors as on the figure above:

Fonts

Use the following properties to change the Badge fonts:

The following code sample sets the FontFamily property to Tahoma, FontSize property to 12, and FontWeight property to Thin:

Animations

The Badge control has fade-in and fade-out animations. Use the AnimationDuration property to specify the animation duration. The following code sample sets the animation duration to 500ms:

Expanded Inheritance Hierarchy

System.Object
    System.Windows.Threading.DispatcherObject
       System.Windows.DependencyObject
          System.Windows.Freezable
             Badge

Expanded See Also

Is this topic helpful?​​​​​​​