Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Collapse]TreeMap Control
   [Expand]Getting Started
   [Expand]Providing Data
   [Expand]Layout Algorithms
   [Collapse]Colorizers
    [Expand]Examples
   [Expand]End-User Interaction
   [Expand]Visual Elements
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[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

Colorizers

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

Expanded Overview

Colorizers allow you to automatically provide colors for tree map items using a color distribution algorithm. To do this, assign the required colorizer, represented by the ITreeMapColorizer 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 the colorizer provides color depends 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 TreeMap 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 designed in the How to: Color TreeMap Using the Gradient Colorizer example and colored using this colorizer.

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 how this colorizer is used in the How to: Color TreeMap Using the Group Gradient Colorizer example.

Expanded Range Colorizer

This colorizer assigns color to the tree map item depending to which range the 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 created in the How to: Color TreeMap Using Range Colorizer example and colored using this colorizer.

Expanded Custom Colorizer

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

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

Expanded See Also

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