constants HistogramViewEnum
The HistogramViewEnum type specifies the items being included in the histogram. Use the HistogramView property to specify the items or bars being displayed in the histogram. The HistogramViewEnum type supports the following values:

 NameValueDescription 
   exHistogramVisibleItems1 The histogram is shown for the visible items only. The Histogram is updated as soon as the control changes its first visible item ( FirstVisibleItem, NextVisibleItem and IsItemVisible properties determines the items to be included in the histogram ), in other words the control gets vertically scrolled.  This flag can be combined with 
  • exHistogramLeafItems
  • exHistogramRecLeafItems
  • exHistogramNoGrouping

 

 
   exHistogramSelectedItems2 The histogram is shown for the selected items only ( SelectCount, SelectedItem property determines the items to be shown in the chart's histogram ). Use the SingleSel property to specify whether the control can select multiple items. Use the SelectOnClick property to disable selecting new items when the user clicks the chart area. The Histogram is updated as soon as the selection is changed. This flag can be combined with:
  • exHistogramLeafItems
  • exHistogramRecLeafItems
  • exHistogramNoGrouping

 
   exHistogramCheckedItems4 The histogram is shown for the checked items only. You must combine this with exHistogramUnlockedItems, exHistogramLockedTopItems or exHistogramLockedBottomItems. The CellState property specifies the state of the cell / item. The histogram includes only items that have the CellState property on 1 ( locked and unlocked items ). By default, the check box should be on the first column ( the column with the index 0 ). Use the high word of the HistogramView property to specify a different column. For instance, if you need to display the histogram based on the check boxes of the column index 5, the HistogramView property should be 0x50000 + exHistogramCheckedItems + exHistogramUnlockedItems. Another sample, if the HistogramView property is exHistogramCheckedItems + exHistogramLockedBottomItems the histogram shows only the checked items in the bottom locked area. The Histogram is updated as soon as the user changes the state of the cell's check box. This flag can be combined with:
  • exHistogramLeafItems
  • exHistogramRecLeafItems
  • exHistogramNoGrouping

 
   exHistogramFilteredItems128 The histogram is shown for the filtered items only. The Histogram is updated as soon as the user changes the control's filter. This flag can be combined with:
  • exHistogramLeafItems
  • exHistogramRecLeafItems
  • exHistogramNoGrouping

 
   exHistogramSelectedBars8 The histogram is shown for the selected bars only. The ItemBar(exBarSelected) property specifies whether a bar is selected or unselected. The ChartSelectionChanged event notifies the application once a new bar is selected or unselected.

 
   exHistogramUnlockedItems16 The histogram is shown only for unlocked items. Use the AddItem/InsertItem methods to add unlocked items. This option can be combined with exHistogramCheckedItems, exHistogramLockedTopItems or exHistogramLockedBottomItems. For instance, if the HistogramView property is exHistogramUnlockedItems + exHistogramLockedTopItems the histogram shows all the items in the unlocked plus the items in the top locked area.   
   exHistogramLockedTopItems32 The histogram is shown only for locked items in the top side of the control. Use the LockedItemCount property to specify how many items are in the locked area. This option can be combined with exHistogramCheckedItems, exHistogramUnlockedItems or exHistogramLockedBottomItems. For instance, if the HistogramView property is exHistogramUnlockedItems + exHistogramLockedTopItems the histogram shows all the items in the unlocked plus the items in the top locked area.  
   exHistogramLockedBottomItems64 The histogram is shown only for locked items in the bottom side of the control. Use the LockedItemCount property to specify how many items are in the locked area. This option can be combined with exHistogramCheckedItems, exHistogramUnlockedItems or exHistogramLockedTopItems. For instance, if the HistogramView property is exHistogramUnlockedItems + exHistogramLockedBottomItems the histogram shows all the items in the unlocked plus the items in the bottom locked area.  
   exHistogramAllItems112 The histogram is shown for all items, locked and unlocked items too. The exHistogramAllItems is a shortcut for the exHistogramUnlockedItems + exHistogramLockedTopItems + exHistogramLockedBottomItems. This flag can be combined with:
  • exHistogramLeafItems
  • exHistogramRecLeafItems
  • exHistogramNoGrouping

 
   exHistogramLeafItems256 The histogram shows the bars for leaf items, in other words, the item itself if contains no child items, or all child items that contains no other child items. Use this flag to include in the histogram the bars in the child items too.

 
   exHistogramRecLeafItems512 The histogram shows all bars for all recursive leaf items, so all child leaf items are displayed. Use this flag to include in the histogram the bars in all child items ( recursively ) too.  
   exHistogramNoGrouping1024 (exHistogramNoGrouping/1024) If present, the histogram shows all bars without grouping based on the item's parent, and so all bars shares the same space for the histogram. If missing, the bars included in the histogram are grouped based on their parents, and each group has allocated a space in the histogram, so each group is shown separately. The exHistogramNoGrouping flag can not be combined with exHistogramNoGroupCaption or exHistogramGroupCumulative flag.

The following screen shot shows the histogram grouped by parent items (exHistogramNoGrouping is not used): 

The following screen shot shows the histogram without grouping  (exHistogramNoGrouping is used):

 
   exHistogramBackground2048 (exHistogramBackground/2048) The histogram's chart goes on the background, while the non-working part is shown on front ( erases the non-working parts ).

The following screen shot shows the histogram with the exHistogramBackground flag set ( histogram on background ):

while the following shows the same histogram with no exHistogramBackground flag ( histogram on front ):

 

 
   exHistogramNoGroupCaption4096 (exHistogramNoGroupCaption/4096) The histogram shows no caption for groups being shown. The exHistogramNoGroupCaption flag has no effect if the exHistogramNoGrouping flag is set.

The following screen shot shows shows the group captions when exHistogramNoGroupCaption flag is not set:

 
   exHistogramGroupCumulative8192 (exHistogramGroupCumulative/8192) The histogram shows cumulative groups. The exHistogramGroupCumulative flag has no effect if the exHistogramNoGrouping flag is set. The HistogramCumulativeColors property of the Bar indicates the number of colors that can be used in the representation. The HistogramCumulativeColor property of the Bar specifies the color to be used in the representation.

The following screen shot shows shows the histogram when the exHistogramGroupCumulative flag is set:

 

Sample 1, will display the histogram for all Task bars:

With G2antt1
	.BeginUpdate 
	.SingleSel = False
	With .Chart
		.FirstVisibleDate = #1/1/2001#
		.LevelCount = 2
		.HistogramVisible = True
		.HistogramHeight = 32
		.HistogramView = 112
		.Bars.Item("Task").HistogramPattern = 6
	End With
	.Columns.Add "Column"
	With .Items
		.AddBar .AddItem("Item 1"),"Task",#1/2/2001#,#1/4/2001#
		.AddBar .AddItem("Item 2"),"Task",#1/3/2001#,#1/7/2001#
	End With
	.EndUpdate 
End With

This sample displays the histogram for all Task bars no matter if the selected items/bars is changed.

Sample 2, will display the histogram for Task bars in the selected items only:

With G2antt1
	.BeginUpdate 
	.SingleSel = False
	With .Chart
		.FirstVisibleDate = #1/1/2001#
		.HistogramVisible = True
		.HistogramView = 2
		.HistogramHeight = 32
		.Bars.Item("Task").HistogramPattern = 6
	End With
	.Columns.Add "Column"
	With .Items
		.AddBar .AddItem("Item 1"),"Task",#1/3/2001#,#1/5/2001#
		.AddBar .AddItem("Item 2"),"Task",#1/4/2001#,#1/7/2001#
		.AddBar .AddItem("Item 3"),"Task",#1/2/2001#,#1/6/2001#
		.SelectAll 
	End With
	.EndUpdate 
End With

This sample displays the histogram for all Task bars in the selected items. Run the sample and selects one or multiple items. The histogram is shown for bars in the selected items only.

Sample 3, will display the histogram for selected Task bars only:

With G2antt1
	.BeginUpdate 
	With .Chart
		.LevelCount = 2
		.PaneWidth(False) = 64
		.FirstVisibleDate = #1/1/2001#
		.HistogramVisible = True
		.HistogramView = 8
		.HistogramHeight = 32
		.Bars.Item("Task").HistogramPattern = 6
	End With
	.Columns.Add "Column"
	With .Items
		.AddBar .AddItem("Item 1"),"Task",#1/3/2001#,#1/5/2001#,1
		.AddBar .AddItem("Item 2"),"Task",#1/4/2001#,#1/7/2001#,2
		.AddBar .AddItem("Item 3"),"Task",#1/2/2001#,#1/6/2001#,3
		.ItemBar(0,2,257) = True
		.ItemBar(0,3,257) = True
	End With
	.EndUpdate 
End With

This sample displays the histogram for all Task bars in the selected items. Run the sample and selects one or multiple items. The histogram is shown for bars in the selected items only.

Sample 4, will display the histogram for checked Task bars only:

With G2antt1
	With .Chart
		.FirstVisibleDate = #1/1/2001#
		.HistogramVisible = True
		.HistogramHeight = 32
		.HistogramView = 276
		.Bars.Item("Task").HistogramPattern = 6
	End With
	.Columns.Add "Column"
	With .Items
		h = .AddItem("Project")
		.CellHasCheckBox(h,0) = True
		.AddBar .InsertItem(h,0,"Item 1"),"Task",#1/2/2001#,#1/4/2001#
		.AddBar .InsertItem(h,0,"Item 2"),"Task",#1/3/2001#,#1/7/2001#
		.ExpandItem(h) = True
	End With
End With

This sample displays the histogram for all Task bars in the checked items. Run the sample and check one or multiple items..

Sample 5, displays the non-working pattern over the bars:

With G2antt1
	.BeginUpdate 
	.Columns.Add "Tasks"
	With .Chart
		.NonworkingDaysPattern = exPatternBDiagonal
		.NonworkingDaysColor = RGB(0,0,0)
		.PaneWidth(0) = 40
		.FirstVisibleDate = #6/20/2005#
		.HistogramVisible = True
		.HistogramHeight = 64
		.HistogramView = HistogramViewEnum.exHistogramUnlockedItems Or HistogramViewEnum.exHistogramLockedTopItems Or HistogramViewEnum.exHistogramLockedBottomItems Or HistogramViewEnum.exHistogramBackground
		.LevelCount = 2
		With .Bars
			With .Add("Empty")
				.Color = RGB(0,0,0)
				.Pattern = exPatternFDiagonal
				.Shape = exShapeSolidFrameless
			End With
			With .Add("Task:Empty")
				.Shortcut = "Task"
				.HistogramItems = -5
				.HistogramCriticalValue = 3
				.HistogramType = exHistOverload
				.HistogramPattern = .Pattern
				.Def(exBarCaption) = "<%=%258%> working days bar"
				.Def(exBarHAlignCaption) = 18
				.Def(exBarKeepWorkingCount) = True
			End With
		End With
		.UnitWidthNonworking = -12
		.Level(1).FormatLabel = "weekday(dvalue) in (0,6) ? `` : value"
	End With
	With .Items
		.AddBar .AddItem("Task A"),"Task",#6/23/2005#,#6/29/2005#,""
		.AddBar .AddItem("Task B"),"Task",#6/24/2005#,#6/28/2005#,""
	End With
	.EndUpdate 
End With

 

 

 


Send comments on this topic.
1999-2017 Exontrol.COM, Software. All rights reserved.