constants LinkPropertyEnum
Use the Link property to access a specified link. The AddLink method can be used to add links programmatically. The AllowLinkBars property indicates whether the user can link bars at runtime. The AllowLink event notifies your application when the user creates a link at runtime. The AddLink event notifies your application once the user adds a link between two bars. The ShowLinksColor property specifies the color for links that starts or ends on selected bars. The ShowLinksStyle property specifies the width to show the links when the link starts from selected bar, ends on selected bar, or when it is not related to any of selected bars. The SelBarColor property specifies the color to display the selected bars.

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

The link between two bars supports the following properties:

 NameValueDescription 
   exLinkStartItem0 Retrieves or sets a value that indicates the handle of the item where the link start. A HITEM expression ( long ), that indicates the handle of the item where the link starts. (long expression)  
   exLinkStartBar1 Retrieves or sets a value that indicates the key of the bar where the link starts. A String expression that indicates the key of the bar where the link starts. (Variant expression)  
   exLinkEndItem2 Retrieves or sets a value that indicates the handle of the item where the link ends. A HITEM expression ( long ), that indicates the handle of the item where the link ends. (long expression)  
   exLinkEndBar3 Retrieves or sets a value that indicates the key of the bar where the link ends. A String expression that indicates the key of the bar where the link ends. (Variant expression)  
   exLinkVisible4 Specifies whether the link is visible or hidden. A Boolean expression that indicates whether the link is visible or hidden. Use the ShowLinks property to hide all links in the control. By default, the exLinkVisible property is True. (boolean expression)  
   exLinkUserData5 Specifies an extra data associated with the link. Use the exLinkUserData option to associate an extra data to your link. (Variant expression)  
   exLinkStartPos6 By default, the exLinkStartPos property is 2(Right). Specifies the position where the link starts in the source item. An AlignmentEnum expression that indicates the position where the link starts. By default, the exLinkStartPos property is RightAlignment. (AlignmentEnum expression)

Links start from right and end on the left part of the bar:

Links start from center and end on right part of the bar:

 
   exLinkEndPos7 By default, the exLinkStartPos property is 0(Left). Specifies the position where the link ends in the target item. An AlignmentEnum expression that indicates the position where the link ends. By default, the exLinkEndPos property is LeftAlignment. (AlignmentEnum expression).

Links start on right and end on the left part of the bar( default ):

Links start on right and end on the center part of the bar:

 
   exLinkColor8 Specifies the color to paint the link. By default, the exLinkColor property is -1 (0xFFFFFFFF). If the exLinkColor property is -1, the control uses the LinksColor property to show the link. If the exLinkColor property is not -1, it indicates the color to draw the link. Use the exLinkArrowColor property to specify a different color to show the link's arrow. The ShowLinksColor property specifies the color to show the links when a bar is being selected. (color expression)

Links show same color:

Links show different colors:

 

 
   exLinkStyle9 Specifies the style to paint the link. A LinkStyleEnum expression that indicates the style of the link between two bars. By default, the exLinkStyle property is -1. If the exLinkStyle property is -1, the LinksStyle property specifies the style of the link. The ShowLinksStyle property specifies the width to show the links when the link starts from selected bar, ends on selected bar, or when it is not related to any of selected bars. (LinkStyleEnum expression)

Links show default style:

Links show different styles:

 
   exLinkWidth10 Specifies the width in pixels of the link. A long expression that indicates the width of the pen, in pixels, to draw the link between two bars. By default, the exLinkWidth property is -1. If the exLinkWidth property is -1, the LinksWidth property indicates the width of the link. The ShowLinksWidth property specifies the width to show the links when the link starts from selected bar, ends on selected bar, or when it is not related to any of selected bars. (long expression)

Links show with different widths:

 
   exLinkShowDir11 Specifies whether the link shows the direction. A Boolean expression that indicates whether the arrow in the link that specifies the direction, is visible or hidden. By default, the exLinkShowDir property is True. (boolean expression)

Links show no direction ( no arrow ):

 
   exLinkText12 Specifies the HTML text being displayed on the link. Use the <img> tag to display an icon or a custom size picture on the link. By default, the exLinkText property is empty, and so the link displays no text or picture. Use the HTMLPicture property to include custom size picture to HTML captions. (string expression)

The link shows a caption on: (<img>word</img> <bgcolor=FFFFFF><a>Link</a></bgcolor>):

 
   exLinkToolTip13 Specifies the HTML text being shown when the cursor hovers the link. Use the <font> element to specify a different font or size for the tooltip, or use the ToolTipFont property to specify a different font or size for all tooltips in the control. (string expression)  
   exLinkArrowColor14 Specifies the color to show the link's arrow. By default, the exLinkArrowColor is -1 ( 0xFFFFFFFF ) which indicates that the exLinkColor property indicates the color to show the link's arrow. If the exLinkArrowColor is not -1, it indicates the color to display the arrow of the link or if the the last 7 bits in the high significant byte of the color indicates the identifier of the skin being used to show the arrow. Use the Add method to add new skins to the control. (color expression)

The arrow or the direction of the Link is displayed with a solid color:

The arrow or the direction of the Link is displayed with an EBN color:

 
   exLinkShowRound15 Specifies whether the link is shown as round or rectangular. By default, the exLinkShowRound property is 0, which means that the link are rectangular ( Currently, it supports only -1, 0 and 1 )

Rectangular links ( exLinkShowRound = 0 ( False ), by default ):

Round links ( exLinkShowRound = -1 ( True ) ):

Direct links ( exLinkShowRound = 1):

Straight links ( exLinkShowRound = 2):

The following screen shot shows the links with different roundness:

 
   exLinkPDMWorkingDelay16 By default, the exLinkPDMWorkingDelay is 0. Specifies the working delay for the activity during PDM scheduling. This property specifies the number of working days between two linked bars. The property keeps count on the non-working area of the chart. The SchedulePDM method uses the exLinkPDMWorkingDelay property when arranging bars, if it is not zero. For instance, if the bar A links to bar B using a FS ( Finish-Start type ), and the exLinkPDMWorkingDelay property is 2 ( working days ), it means the bar B starts 2 working days after activity A ends. ( double expression)  
   exLinkPDMDelay17 By default, the exLinkPDMDelay is 0. Specifies the delay for the activity during PDM scheduling. Specifies the delay for the activity during PDM scheduling. This property specifies the number of days between two linked bars. The property does not keeps count on the non-working area of the chart. The SchedulePDM method uses the exLinkPDMDelay property when arranging bars, if it is not zero. For instance, if the bar A links to bar B using a FS ( Finish-Start type ), and the exLinkPDMWorkingDelay property is 2 ( days ), it means the bar B starts 2 days after activity A ends. ( double expression)  
   exLinkSelected257 Specifies whether the link is selected or unselected. By default, the exLinkSelected is False. The AllowSelectObjects property allows users to select at runtime the bars and links in the chart area. The ChartSelectionChanged event is fired when the selection in the chart is changed. The ShowLinksColor property specifies the color to show the links when a bar is being selected. The ShowLinksWidth property specifies the width to show the links when the link starts from selected bar, ends on selected bar, or when it is not related to any of selected bars. The ShowLinksStyle property specifies the width to show the links when the link starts from selected bar, ends on selected bar, or when it is not related to any of selected bars. (boolean expression)  
   exLinkGroupBars258 Groups or ungroup the bars being linked with the specified options ( combination of GroupBarsOptionsEnum type ) . For instance. this option is equivalent with grouping the end of starting bar with the start of the ending bar of the link. For instance, the .Link(LinkKey, exLinkGroupBars) = GroupBarsOptionsEnum.exPreserveBarLength + GroupBarsOptionsEnum.exFlexibleInterval + GroupBarsOptionsEnum.exIgnoreOriginalInterval is equivalent with .GroupBars .Link(LinkKey, exLinkStartItem), .Link(LinkKey, exLinkStartBar), False, .Link(LinkKey, exLinkEndItem), .Link(LinkKey, exLinkEndBar), True, GroupBarsOptionsEnum.exPreserveBarLength + GroupBarsOptionsEnum.exFlexibleInterval + GroupBarsOptionsEnum.exIgnoreOriginalInterval. The GroupBars method groups two bars. If calling the set property, the value of the exLinkGroupBars option can be a a long expression that specifies a combination of GroupBarsOptionsEnum type, or a string expression in format groupbarsoptions;options, where the first argument indicates the value of GroupBarsOptionsEnum type, since the rest of asguments, are passed to Options parameter of the GroupBars method to specify a fixed interval, a minimum interval value and so on. The AddLink event notifies your application once the user adds a link between two bars.

The following VB sample groups the bars being linked:

Private Sub G2antt1_AddLink(ByVal LinkKey As String)
    With G2antt1.Items
        .Link(LinkKey, exLinkGroupBars) = GroupBarsOptionsEnum.exFlexibleInterval Or GroupBarsOptionsEnum.exPreserveBarLength Or GroupBarsOptionsEnum.exIgnoreOriginalInterval
    End With
End Sub

The following C# sample groups the bars being linked:

private void exg2antt1_AddLink(object sender, string LinkKey)
{
    exg2antt1.Items.set_LinkGroupBars(LinkKey, exontrol.EXG2ANTTLib.GroupBarsOptionsEnum.exFlexibleInterval | 
        exontrol.EXG2ANTTLib.GroupBarsOptionsEnum.exIgnoreOriginalInterval | 
        exontrol.EXG2ANTTLib.GroupBarsOptionsEnum.exPreserveBarLength);
}

Once the user moves a grouped bar, the relative bar is moved resized accordingly with the grouping options.

 
   exLinkKey259 Changes the key of the giving link. The get function retrieves the link's key if the link is found, else it returns an empty string. You can use the get_LinkKey function to check if a specified link is found or not. The set function may be used to rename the key of the link, when AddLink event is fired. The key of the link may be changed if the new key is available, in other words, if there is no other link with the new key.   
   exLinksCount512 Specifies the number of the links within the chart. (long expression)  
 

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