Skip to main content
BuyLog In
WinForms Controls
Search in…
Docs > Controls and Libraries > Diagrams > Themes and Styles
All docs
V24.2
WinForms Controls
.NET Support and Migration
Prerequisites
What's New
What's Installed
Build an Application
Redistribution and Deployment
Controls and Libraries
Forms and User Controls
Messages, Notifications, and Dialogs
Editors and Simple Controls
Ribbon, Bars and Menu
Application UI Manager
Docking Library
Data Grid
Vertical Grid
Property Grid
Pivot Grid
Tree List
Gantt Control
Chart Control
Diagrams
Getting Started
Diagram Control
End-User Interaction
Diagram Items
Automatic Layout
Generate Diagrams from a Data Source
Themes and Styles
Printing and Exporting
Saving and Loading Diagrams
Examples
Gauges
Map Control
Scheduler
Spreadsheet
Rich Text Editor
Spell Checker
Form Layout Managers
Navigation Controls
Printing-Exporting
PDF Viewer
Reporting
Office File API
Snap
TreeMap Control
Sunburst Control
Sankey Diagram Control
Heatmap Control
Icon and Image Library
AI-powered Extensions
Common Features
Security Considerations
Data Access Security
Hybrid & Enterprise Development
UI Templates
Desktop & Web App UI Framework (Powered by EF Core)
Get More Help
API Reference
Download CHM

Themes and Styles

  • 2 minutes to read

Overview

Diagram themes are predefined sets of diagram item styles that can be applied to a diagram in a single click. Each theme consists of font settings and a set of styles that can be applied to individual diagram items. Styles are a combination of background, foreground and stroke colors used to paint an item.

Diagram themes are encapsulated by DiagramTheme class objects. The static ThemeRegistrator class provides methods to manage the collection of themes.

The DevExpress.Diagram.Core.DiagramThemeColorId enumeration stores identifiers of theme colors. The DiagramTheme.ColorPalette property provides access to the theme’s color scheme.

The DiagramTheme.EffectCollection property provides access to the collection of effects that defines how colors are used in the theme. It returns an object of the DiagramEffectCollection type that has the following properties:

  • DiagramEffectCollection.ThemeEffects - Provides access to the collection of effects that can be applied to shapes and are displayed in the “Theme Styles” ribbon group. This collection contains exactly six elements.
  • DiagramEffectCollection.VariantEffects - Provides access to the collection of effects that can be applied to shapes and are displayed in the “Variant Styles” ribbon group. This collection contains exactly four elements.
  • DiagramEffectCollection.ConnectorEffects - Provides access to the collection of effects that can be applied to connectors. This collection contains exactly three elements.

Item styles are encapsulated by DiagramItemStyle class objects.

The DiagramItem.ThemeStyleId property value identifies the style applied to the item. Identifiers for available shape and connector styles are stored in the DevExpress.Diagram.Core.DiagramShapeStyleId and DevExpress.Diagram.Core.DiagramConnectorStyleId classes correspondingly.

Applying Themes and Styles

End-users can apply a theme by selecting it in the Ribbon‘s Themes group on the Design page. The Shape styles group on the Home page allows end-users to apply styles to the selected items.

Themes Design-time

To apply a theme in code, use the DiagramOptionsView.Theme property. The static DevExpress.Diagram.Core.DiagramThemes class contains themes that are available by default. The ThemeRegistrator.Themes collection stores currently registered themes.