Exontrol - Gantt Chart ActiveX, NET, WPF Control

Use the ItemBar property to access properties related to the bars being shown in the item. You can change a property for all bars with a specified key, from all items, by using the Item parameter on 0. For instance, the ItemBar(0,"K1",exBarColor) = RGB(255,0,0) changes the color for all bars with the key K1, from all items. If the Item parameter indicates a valid item, the bars referred is only inside the item. For instance, the ItemBar(FirstVisibleItem,"K1",exBarColor) = RGB(255,0,0) changes the color for the bar in the first visible item with the key K1.

Use the AddBar property to add new bars to the item. Use the FirstVisibleDate property to specify the first visible date in the chart area. Use the RemoveBar method to remove a bar from an item. Use the ClearBars method to remove all bars in the item. Use the Refresh method to refresh the chart.

The /NET Assembly version defines get/set shortcut properties as follow ( they start with get_ or set_ keywords ):

BarName : String, retrieves or sets a value that indicates the name of the bar
BarStart : DateTime, retrieves or sets a value that indicates the start of the bar
BarEnd : DateTime, retrieves or sets a value that indicates the end of the bar
BarCaption : String Retrieves or sets a value that indicates the caption being assigned to the bar
BarHAlignCaption : AlignmentEnum, retrieves or sets a value that indicates the horizontal alignment of the caption inside the bar
BarVAlignCaption : VAlignmentEnum, retrieves or sets a value that indicates the vertical alignment of the caption inside the bar
BarToolTip : String, retrieves or sets a value that indicates the tooltip being shown when the cursor hovers the bar
BarBackColor : Color, retrieves or sets a value that indicates the background color for the area being occupied by the bar
BarForeColor : Color, retrieves or sets a value that indicates the foreground color for the caption of the bar
BarKey : Object, specifies key of the bar
BarPercent : Double, specifies the percent to display the progress on the bar
BarPercentCaptionFormat : String, specifies the HTML format to be displayed as percent
BarShowPercentCaption : Boolean, specifies whether the percent is displayed as caption on the bar
BarAlignPercentCaption : AlignmentEnum, specifies the alignment of the percent caption on the bar
BarData : Object, associates an extra data to a bar
BarOffset : Integer, specifies the vertical offset where the bar is shown
BarTransparent : Integer, specifies the percent of the transparency to display the bar
BarsCount : Integer, retrieves a value that indicates the number of bars in the item
BarWorkingCount : Integer, specifies the count of working units in the bar
BarNonWorkingCount : Integer, retrieves the count of non-working units in the bar
BarColor : Color, specifies the color for the bar. If used it replaces the bar's type color, for current bar only.
BarDuration : Double, specifies the duration of the bar in days
BarMove: Double, moves the bar by specified amount of time

So instead using the get_ItemBar or set_ItemBar properties you can use these functions.

For instance, the following sample changes the bar's color:

With Exgantt1.Items
    .set_BarColor(.FocusItem, .get_FirstItemBar(.FocusItem), Color.Red)
End With

The following VB sample changes the end date for the bar in the first visible item ( in this sample we consider that AddBar method was used with the Key parameter as being empty ) :

With Gantt1.Items
    .ItemBar(.FirstVisibleItem, "", exBarEnd) = "6/19/2005"
End With

The following C++ sample changes the end date for the bar in the first visible item:

CItems items = m_gantt.GetItems();
items.SetItemBar( items.GetFirstVisibleItem(), COleVariant(""), 2 /*exBarEnd*/, COleVariant("6/19/2005") );

The following VB.NET sample changes the end date for the bar in the first visible item:

With AxGantt1.Items
    .ItemBar(.FirstVisibleItem, "", EXGANTTLib.ItemBarPropertyEnum.exBarEnd) = "6/19/2005"
End With

The following C# sample changes the end date for the bar in the first visible item:

axGantt1.Items.set_ItemBar(axGantt1.Items.FirstVisibleItem, "", EXGANTTLib.ItemBarPropertyEnum.exBarEnd, "6/19/2005");

The following VFP sample changes the end date for the bar in the first visible item:

with thisform.Gantt1.Items
	.DefaultItem = .FirstVisibleItem
	thisform.Gantt1.Template = "Items.ItemBar(0,`" + _key + "`,2 ) = `20/07/2005`"
endwith

where the _key is the key of the bar being resized.

The VFP sample uses the Template property in order to execute the ItemBar property, else some version of VFP could fire "Function argument, value, type, or count is invalid". The sample builds the script:

Items.ItemBar(0,_key,2) = `20/07/2005`

This way the ItemBar property for the default item is invoked

Send comments on this topic.

		Type	Description
		Item as HITEM	A long expression that indicates the the handle of the item where the bar is removed.
		Key as Variant	Optional. A String expression that indicates the key of the bar being accessed. If missing, the Key parameter is empty. If the Item has only a single Bar you may not use the Key parameter, else an unique key ( in the same bars of the item ) should be used.
		Property as ItemBarPropertyEnum	An ItemBarPropertyEnum expression that indicates the property being accessed
		Variant	A Variant expression that indicates the property's value.