property Bar.HistogramType as HistogramTypeEnum
Retrieves or sets a value that indicates the type of the histogram.

TypeDescription
HistogramTypeEnum A HistogramTypeEnum expression that specifies the type of the histogram-graph to be shown for this bar.
By default, the HistogramType property is exHistOverload. Use the HistogramType property to specify the histogram-graph to be displayed for a specified bar. A bar is represented in the histogram only if HistogramPattern or HistogramColor property is set. Use the HistogramColor property to define the color or the EBN/skin file of the pattern to be displayed in the histogram. Use the HistogramCriticalValue property to specify a critical value. The critical value is interpreted differently based on the HistogramType property. For instance, if the HistogramType property is exHistOverload, the critical value represents the count of cumulative bars since if the HistogramType property is exHistOverAllocation the critical value represents a percent value. Use the HistogramCriticalColor property to specify the color to display the critical values. Use HistogramRulerLinesColor property to specify the color to show the ruler in the left part of the histogram. The ShowHistogramValues property specifies the formula that returns the color to display the selected values in the histogram for specified type of bar.

Currently the HistogramType property supports the following values:

  1. exHistOverload the histogram-graph shows the count of task day by day or unit by unit. The ItemBar(exBarEffort) specifies the number of units to count for the bar. For instance, if the bars display activities the exBarEffort value can represent the number of workers for each activity so the overload histogram displays the total number of workers on the activity. Use the HistogramGridLinesColor specifies the color to show the grid lines when the HistogramType property is exHistOverload. Use the HistogramItems property to specify the number of items allocated for the current bar to be shown in the histogram. The exHistOverload type can be combined with exHistCumulative.

    The following screen shot shows the exHistOverload histogram when exBarEffort property is 1 ( by default ):

    The following screen shot shows the exHistOverload histogram when exBarEffort property is different for bars as seen in the columns section: 

  2. exHistOverAllocation the histogram shows the work-loads. The work-load for a task is computed as ItemBar(exBarEffort) / length of the bar. The work-load for the task is the work effort / task duration. (i.e. If  item.exBarEffort = 1 and gantt bar length is 10 days, then the work-load = 0.1 or 10%). The histogram- graph shows the sum of the work-loads (the work-load of each task item is added, unit by unit). The exHistOverload type can be combined with exHistCumulative.

    The following screen shot shows the exHistOverallocation histogram when exBarEffort property is 1 ( by default ):

    The following screen shot shows the exHistOverallocation histogram when exBarEffort property is different for bars as seen in the columns section: 

  3. exHistCumulative the histogram shows the overloads or work-loads using cumulative values and different colors . This option should be combined with exHistOverload to show a cumulative overload histogram, or with the exHistOverAllocation to show a cumulative work loads histogram. The HistogramCumulativeColors property defines the number of colors being displayed in the cumulative histogram.  The HistogramCumulativeColor property specifies a cumulative color based on its index. Use the HistogramCumulativeShowLegend property to specify the index of the column being shown in the left side of the histogram to show the legend of the colors being used for cumulative bars. The HistogramPattern property should not be a curve, in order to show a cumulative histogram, in other words should be a predefined pattern.  You can change the original color of the bars that generates the cumulative histogram using the HistogramCumulativeOriginalColorBars property. The following screen shot shows the bars using the original color in the items that generates the histogram (when HistogramCumulativeOriginalColorBars property is True, by default ). 

The following screen shot shows the exHistOverload + exHistCumulative histogram when exBarEffort property is 1 ( by default ), and the HistogramCumulativeOriginalColorBars property is False:

The following screen shot shows the exHistOverload + exHistCumulative histogram when exBarEffort property is different, , and the HistogramCumulativeOriginalColorBars property is False: