property Bar.HistogramPattern as PatternEnum
Retrieves or sets a value that indicates the pattern to be used in the histogram.

 TypeDescription 
   PatternEnum A PatternEnum expression that specifies the pattern to be used to display the bar in the histogram  
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. The AntiAliasing property specifies whether lines, curves or edges are shown smoothly using the antialiasing rendering. The HistogramBorderColor property specifies the color to show the border for values in the histogram. The ResizeUnitScale property determines the refinement for the histogram part. For instance, if the chart displays days, while the bars are represented up to hours, the ResizeUnitScale property on exHour, will determine the histogram to show up to hours.

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 following screen shot shows the bar's diagram if the HistogramPattern property is exPatternBDiagonal. This histogram shows the diagram using a predefined patterns ( value should be greater than 1 and less then 255 ).

( HistogramPattern value from 1 to 255  )

The following screen shot shows the bar's diagram if the HistogramColor property points an EBN object ( 0x01000000, defines the EBN object being used to show the task bars ). In case the HistogramColor property points to an EBN/Skin object ( the first 7 bites of the color are used ) the HistogramPattern property has no effect, so the EBN object is used to show the diagram.

( HistogramColor defines the EBN/Skin object, HistogramPattern does not count  )

The following screen shot shows the bar's diagram if the HistogramColor property points an EBN object ( 0x01000000, defines the EBN object being used to show headers )

( HistogramColor defines the EBN/Skin file used, HistogramPattern does not count  )

The following screen shot shows the bar's diagram if the HistogramPattern property is exPolygonCurve + exPatternYard

( HistogramPattern value is 256 + value from (1 to 255)  )

The following screen shot shows the bar's diagram if the HistogramPattern property is exPolygonCurve + exPatternEmpty, or simple exPolygonCurve

( HistogramPattern value is 256 )

The following screen shot shows the bar's diagram if the HistogramPattern property is exPolygonCurve + exPatternEmpty, or simple exPolygonCurve, the AntiAliasing property is True, and the HistogramColor and HistogramBorderColor propertis have different values.

( HistogramPattern value is 256, AntiAliasing = True, HistogramColor != HistogramBorderColor  )

The following screen shot shows the bar's diagram if the HistogramPattern property is exRectangularCurve + exPatternYard

( HistogramPattern value is 2048 + value from (1 to 255)  )

The following screen shot shows the bar's diagram if the HistogramPattern property is exRectangularCurve + exPatternEmpty, or simple exRectangularCurve

( HistogramPattern value is 2048 )

The following screen shot shows the bar's diagram if the HistogramPattern property is exRectangularCurve + exPatternEmpty, or simple exRectangularCurve, the AntiAliasing property is True, and the HistogramColor and HistogramBorderColor propertis have different values.

( HistogramPattern value is 2048, AntiAliasing = True, HistogramColor != HistogramBorderColor  )

The following screen shot shows the bar's diagram if the HistogramPattern property is exBezierCurve + exPatternYard

( HistogramPattern value is 512 + value from (1 to 255) )

The following screen shot shows the bar's diagram if the HistogramPattern property is exBezierCurve + exPatternEmpty, or simple exBezierCurve

( HistogramPattern value is 512  )

The following screen shot shows the bar's diagram if the HistogramPattern property is exBezierCurve + exPatternEmpty, or simple exBezierCurve, the AntiAliasing property is True, and the HistogramColor and HistogramBorderColor propertis have different values.

( HistogramPattern value is 512, AntiAliasing = True, HistogramColor != HistogramBorderColor  )

The following screen shot shows the bar's diagram if the HistogramPattern property is exRoundCurve + exPatternYard

( HistogramPattern value is 1024 + value from (1 to 255) )

The following screen shot shows the bar's diagram if the HistogramPattern property is exRoundCurve + exPatternEmpty, or simple exRoundCurve

( HistogramPattern value is 1024  )

The following screen shot shows the bar's diagram if the HistogramPattern property is exRoundCurve + exPatternEmpty, or simple exRoundCurve, the AntiAliasing property is True, and the HistogramColor and HistogramBorderColor propertis have different values.

( HistogramPattern value is 1024, AntiAliasing = True, HistogramColor != HistogramBorderColor  )

The following screen shot shows the bar's diagram if the HistogramPattern property is exPatternShadow, the HistogramType property includes the exHistCumulative flag, and the HistogramCumulativeOriginalColorBars property is False.

( HistogramPattern value is between 1 and 255 and HistogramType property includes the exHistCumulative flag  )

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

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-2017 Exontrol.COM, Software. All rights reserved.