Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]Welcome to DevExpress .NET Documentation
[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]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
   Reporting
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Printing-Exporting
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Collapse]TreeMap Control
   [Expand]Getting Started
   [Expand]Providing Data
   [Expand]Layout Algorithms
   [Collapse]Colorizers
    [Expand]Examples
   [Expand]End-User Interaction
   [Expand]Visual Elements
  [Expand]Diagram Control
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[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

Colorizers

This document describes the Colorizers used by the TreeMap control in detail. It consists of the following sections.

Expanded Overview

Colorizers allows you to automatically provide colors for tree map items using a color distribution algorithm. To do this, assign the required colorizer, represented by the TreeMapColorizerBase class descendant to the TreeMapControl.Colorizer property.

After that customize algorithm settings. The next sections describe colorizers and their settings in detail.

Expanded Palette Colorizer

This colorizer for each leaf or group tree map item assigns a new color from a palette.

The way how the colorizer provides color is dependent on the TreeMapPaletteColorizer.ColorizeGroups property value. The following table demonstrates the difference.

The property value. The resulting image.
TreeMapPaletteColorizer.ColorizeGroups = false
TreeMapPaletteColorizer.ColorizeGroups = true

To change a palette used by the colorizer, use the TreeMapPaletteColorizerBase.Palette property.

Refer to the How to: Color Tree Map Using the Palette Colorizer example to learn more.

Expanded Gradient Colorizer

This colorizer for each leaf tree map item provides a color blended from TreeMapGradientColorizer.StartColor and TreeMapGradientColorizer.EndColor. The color proportion is dependent on item values. The following image demonstrates the TreeMap colored using this colorizer.

Refer to the How to: Color Tree Map Using the Gradient Colorizer example to learn more.

Expanded Group Gradient Colorizer

This colorizer provides colors to leaf tree map items using the following principle. For each group, a color from TreeMapPaletteColorizerBase.Palette is assigned. Then, group color is blended with TreeMapGroupGradientColorizer.GradientColor in proportion depending on the item value. The portion of group color is between TreeMapGroupGradientColorizer.Min and TreeMapGroupGradientColorizer.Max values. The following image demonstrates this colorizer in action.

Refer to the How to: Color Tree Map Using the Group Gradient Colorizer example to learn more.

Expanded Range Colorizer

This colorizer assigns color to the tree map item depending on which range tree map item value belongs to. Ranges can be specified using TreeMapRangeColorizer.RangeStops. Colors assigned to ranges are taken from the TreeMapPaletteColorizerBase.Palette. The next image shows the TreeMap colored using this colorizer.

Refer to the How to: Color Tree Map Using Range Colorizer example to learn more.

Expanded Custom Colorizer

The TreeMap allows you to apply a custom colorizer. To do this, design a class derived the TreeMapColorizerBase class and implement its TreeMapColorizerBase.GetItemColor method.

Refer to the How to: Implement a Custom Colorizer example to learn more.

Expanded See Also

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