Name | Value | Description | |||
exHistogramVisibleItems | 1 |
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
| |||
exHistogramSelectedItems | 2 |
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:
| |||
exHistogramCheckedItems | 4 |
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:
| |||
exHistogramFilteredItems | 128 |
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:
| |||
exHistogramSelectedBars | 8 | 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. | |||
exHistogramUnlockedItems | 16 | 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. | |||
exHistogramLockedTopItems | 32 | 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. | |||
exHistogramLockedBottomItems | 64 | 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. | |||
exHistogramAllItems | 112 |
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 | 256 | 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. | |||
exHistogramRecLeafItems | 512 | 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. | |||
exHistogramNoGrouping | 1024 |
(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):
| |||
exHistogramBackground | 2048 |
(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 ):
| |||
exHistogramNoGroupCaption | 4096 |
(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: | |||
exHistogramGroupCumulative | 8192 |
(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