By default, the HistogramPattern property is exPatternEmpty. By default, no bar is represented in the histogram. 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 HistogramBackColor property to specify the histogram's background color. Use the HistogramType property to specify the type of the graph to be displayed in the histogram for specified bar.

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:

• The HistogramType property indicates the type of the histogram being displayed for a specified bar.
• Use the HistogramView property to specify the items being represented in the histogram view. By default, only visible items are displayed in the histogram. For instance, using the HistogramView property you can select the items being represented in the histogram
• Use the HistogramBackColor property to specify the histogram's background color. 

 

If the HistogramPattern property is a predefined value, the PatternEnum type specifies the shape of the histogram as shown bellow ( exPatternDot, exPatternBox and exPatternEmpty ):

• If the HistogramPattern property is 256, the rectangular curves shows the overloads and subloads of the bar in the specified range of data as follows:

  

• If the HistogramPattern is 256 plus a predefined PatternEnum value, the histogram shows like follows ( in this case the HistogramPattern property is 256 +  exPatternVertical = 264 ):

  

• If the HistogramPattern property is 512, the bezier curves shows the overloads and subloads of the bar in the specified range of data as follows:

  

• If the HistogramPattern property is 1024, the round curves shows the overloads and subloads of the bar in the specified range of data as follows:

  

Bellow you can find how histogram is updated automatically as soon as the user moves or resizes a bar:

Use the HistogramVisible property to show or hide the histogram. Use the HistogramHeight property to specify at runtime the height of the histogram.

 

---

Send comments on this topic.

© 1999-2008 Exontrol Inc, Software. All rights reserved.