Back to Devexpress

TreeMapColorizerBase.ValueProvider Property

windowsforms-devexpress-dot-xtratreemap-dot-treemapcolorizerbase-f5bac7b5.md

latest3.4 KB
Original Source

TreeMapColorizerBase.ValueProvider Property

Gets or sets a provider of values the colorizer uses to determine colors for treemap items.

Namespace : DevExpress.XtraTreeMap

Assembly : DevExpress.XtraTreeMap.v25.2.dll

NuGet Package : DevExpress.TreeMap

Declaration

csharp
[DefaultValue(null)]
[XtraSerializableProperty(XtraSerializationVisibility.Hidden)]
public IColorizerValueProvider ValueProvider { get; set; }
vb
<DefaultValue(Nothing)>
<XtraSerializableProperty(XtraSerializationVisibility.Hidden)>
Public Property ValueProvider As IColorizerValueProvider

Property Value

TypeDefaultDescription
IColorizerValueProvidernull

An object of a class that implements the IColorizerValueProvider interface.

|

Remarks

Treemap colorizers uses item values (TreeMapItem.Value, TreeMapFlatDataAdapter.ValueDataMember, or HierarchicalDataMapping.ValueDataMember) to determine colors. You can use the ValueProvider property to specify a custom value source for a colorizer.

If ValueProvider is specified, a custom colorizer also uses its returned values to determine colors.

The following example shows how to make a treemap colorizer determine item colors based on the bound data source’s “HPI” row values:

csharp
((TreeMapColorizerBase)treeMapControl1.Colorizer).ValueProvider = new ColorizerValueProvider();
//...
public class ColorizerValueProvider : IColorizerValueProvider {
    double IColorizerValueProvider.GetValue(IHierarchicalItem item, int itemIndex) {
        DataRowView row = item.Tag as DataRowView;
        if (row != null)
            return (double)row["HPI"];
        return 0;
    }
}
vb
CType(treeMapControl1.Colorizer, TreeMapColorizerBase).ValueProvider = New ColorizerValueProvider()
'...
Public Class ColorizerValueProvider
    Inherits IColorizerValueProvider

    Private Function GetValue(ByVal item As IHierarchicalItem, ByVal itemIndex As Integer) As Double
        Dim row As DataRowView = TryCast(item.Tag, DataRowView)
        If row IsNot Nothing Then Return CDbl(row("HPI"))
        Return 0
    End Function
End Class

See Also

TreeMapColorizerBase Class

TreeMapColorizerBase Members

DevExpress.XtraTreeMap Namespace