The PutRes method associates an eXG2antt (Source) control with another eXG2antt (Target) control, using the Items.ItemBar(exBarResources). The Source displays the bar and the resources to be used by each bar, while the Target shows the Resources being used by each bar found in the Source. A resource is identified by a name like R1, or a name followed by its usage in percent, like R1[20%], which indicates that the bar uses the resource R1 on 20% of its full capacity.

The following sample shows the bar's allocation of resources: ( for instance the Task 1 uses the R1, Task 2 uses the R1 and R2, while Task 3 uses R2 on 60% and R3 on 39%, and so on )

(source, picture 1)

while the next picture shows the resource usage being taken from the first picture ( for instance, the R1 is being used by Task 1 and Task 2, R2 is used by Task 2, Task 3 on 60% and Task 4, and so on ) :

 

(target, picture 2)

The Source ( picture 1 ) is the original control  that displays your activities / bars. Use the Source.PutRes( Target.ResHandle, exPutResSave ) to update the bar's resources in a Source control, from a Target control. IN a Source control, you can use the following properties to specify the usage of resources.

• exBarResources property (get/set) indicates the resources to be used by the current bar in the Source, as a string expression. The exBarResources property is a string expression that indicate the list of resources ( including its usage, or 100% if missing ). The resources are separated by , ( comma ) character, while the usage is specified as a double expression ( using the . dot character as a decimal separator ).  For instance the "Resource1,Resource2,Resource3" indicates that the bar uses the Resource1,Resource2,Resource3, while "R1,R2[50%],R3[67.89%]" specifies that the bar uses the R1 on 100%, R2 on 50% and R3 on 67.89%. 

You can use the exBarCaption to display the bar's resources using the <%=formula%> format, like in the following VB sample:

With G2antt1.Chart.Bars("Task")
    .Def(EXG2ANTTLibCtl.ItemBarPropertyEnum.exBarCaption) = "<%=%" & EXG2ANTTLibCtl.ItemBarPropertyEnum.exBarResources & "%>"
    .Def(EXG2ANTTLibCtl.ItemBarPropertyEnum.exBarHAlignCaption) = 18
End With

In other words, the sample allows you to display the bar's exBarResources property as shown bellow:

The set exBarResources property could be used in the following format based on the first character as listed: 

• If the first character is +(plus), the rest of the expression indicates the resources to be assigned to the current bar. For instance, if the current bar has the exBarResources property as "R1,R2" , and we call set exBarResources as "+R3", it means that the R3 is added to the bar's resources, and so the new exBarResources property is "R1,R2,R3".
• If the first character is -(minus), the rest of the expression indicates the resources to be removed from the current bar. For instance, if the current bar has the exBarResources property as "R1,R2" , and we call set exBarResources as "-R2", it means that the R2 is removed from the bar's resources, and so the new exBarResources property is "R1".
• If no +,- character, the new expression replaces the exBarResources property. For instance, if the current bar has the exBarResources property as "R1,R2" , and we call set exBarResources as "R3,R4", it means that the new exBarResources property is "R3,R4".

• exBarResourceFormat property (get/set) indicates the format or the expression to be used if you need to display the bar's resource in a different format, in Source, as a string expression. The expression supports the name keyword which indicates the name of the resource, and the percent keyword to get the usage percent a a double expression between 0 and 1. The expression supports all predefined functions listed here. Use the exBarResourcesFormat ( NOT exBarResourceFormat, whith no s ) to get the HTML value of the formatted string using the bar's resources. For instance, let's say we need to display the resource names in bold, and the usage percent in a smaller font and a different foreground color, so the Items.ItemBar(exBarResourceFormat) property could be "`<b>` + name + `</b><font ;5><fgcolor=404040>` + (percent = 1 ? `` : (round(100*percent) format ``) + `%` ) + `</fgcolor></font>`", and so the VB sample could show as:

With G2antt1.Chart.Bars("Task")
    .Def(exBarResourceFormat) = "`<b>` + name + `</b><font ;5><fgcolor=404040>` + (percent = 1 ? `` : (round(100*percent) format ``) + `%` ) + `</fgcolor></font>`"
    .Def(EXG2ANTTLibCtl.ItemBarPropertyEnum.exBarCaption) = "<%=%" & EXG2ANTTLibCtl.ItemBarPropertyEnum.exBarResourcesFormat & "%>"
    .Def(EXG2ANTTLibCtl.ItemBarPropertyEnum.exBarHAlignCaption) = 18
End With

In other words, the sample allows you to display the bar's exBarResources property as shown bellow:

 

• exBarResourcesFormat property (get only ) returns formatted expression of the exBarResources using the exBarResourceFormat ( no s, so it is exBarResourceFormat, not exBarResourcesFormat ). 
• exBarResourcesNames property (get only ) returns the name of each resource to be used by the current bar, in the Source, as a string expression. This option returns no percent or usage of any resource. For instance, if the exBarResources property is "R3[67.89%],R4[23.23%]", the exBarResourcesNames property gets the "R3,R4".
• exBarResourcesUsages property (get only ) returns the usage ( double expression from 0 to 1 ) of each resource to be used by the current bar, in the Source, as a string expression. This option returns no name any resource. For instance, if the exBarResources property is "R3[67.89%],R4[23.23%]", the exBarResourcesUsages property gets the "0.6789,0.2323".

The Target ( picture 2 ) is the control that displays the Resources column, where all resources found are being added line by line, and its usage on items. Use the Target.PutRes(Source.ResHandle, exPutResLoad) to update the Target control from a Source control. IN a Target control, you can use the following properties to specify the usage of resources.

• exBarPercent property (get/set only ) specifies the usage of the resource in the current bar/activity. The following VB sample updates the exBarEffort ( so the histogram will be shown accordingly ) once the user resizes a bar:

Private Sub G2antt1_BarResizing(ByVal Item As EXG2ANTTLibCtl.HITEM, ByVal Key As Variant)
    With G2antt1.Items
        .ItemBar(Item, Key, EXG2ANTTLibCtl.ItemBarPropertyEnum.exBarEffort) = .ItemBar(Item, Key, EXG2ANTTLibCtl.ItemBarPropertyEnum.exBarPercent)
    End With
End Sub

---

Send comments on this topic.

© 1999-2012 Exontrol.COM, Software. All rights reserved.