property Chart.HistogramVisible as Boolean
Specifies whether the chart's histogram layout is visible or hidden.

TypeDescription
Boolean A Boolean expression that specifies whether the histogram is visible or hidden. The True value indicates whether the histogram is visible, The False value indicates whether the histogram is hidden.
By default, the HistogramVisible property is False ( hidden ). The control allows showing workload and capacity by a histogram that automatically adapts to your current planning situation. The histogram may show the overloads, overallocations and subloads for visible bars, or for selected bars. Over-loads and Sub-loads can be shown in several ways using curves, patterns or colors in the same histogram. They are updated interactively, so as user moves or resizes a bar, the histogram is updated automatically. Use the OnResizeControl property on exDisableHistogram to prevent resizing the histogram at runtime. The HistogramBoundsChanged event notifies your application when the location and the size of the chart's histogram is changed, so you can use it to add your legend for the histogram in a panel component. The HistogramHeaderVisible property to show the chart's header in bottom 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. The HistogramValueFromPoint property gets the value in the histogram from the specified location.

The following screen shot shows the over-allocation histogram

The following screen shot shows the over-load histogram:

 

The following screen shot shows the cumulative histogram:

The following screen shot shows the cumulative histogram, including the values, and the legend in the left side of the histogram:

Please follow the steps in order to view your bars in the histogram.

  1. Changes the HistogramVisible property on True ( by default, it is False ). After setting the HistogramVisible property on True, the control shows a horizontal splitter in the bottom side of the control.
  2. Adjusts the height of the histogram view using the HistogramHeight property ( by default it is 0 ). After setting the HistogramHeight property on a value greater than 0, the control shows a the histogram view in the bottom side of the control.
  3. Changes the HistogramPattern or/and HistogramColor property, else no bars will be shown in the histogram. The HistogramPattern/HistogramColor properties belong to a Bar object. For instance the Chart.Bars("Task").HistogramPattern = exPatternDot, specifies that the Task bars will be represented in the histogram using the exPatternDot pattern ()

The followings are optional properties that you can set in order to customize your histogram:

A bar is represented in the histogram only if HistogramPattern or HistogramColor property is set. If any of these are not set, the bar will not be represented in the histogram.

The following screen shot shows the exHistOverload histogram and how it is updated as soon the bars are moved or resized:

The following screen shot shows the exHistOverAllocation histogram and how it is updated as soon the bars are moved or resized:

 

Bellow you can view few screen shots of histograms being displayed in different ways, using different color, patterns, curves or EBN skin files:

Use the Background(exSplitBar) property to define the shape and the color for horizontal split bar, that may be used to resize the histogram at runtime.