VARCHART XGantt_v5.1用戶手冊：如何計算活動結束日期（.NET版）

VARCHART XGantt是一個交互式的甘特圖控件，其模塊化的設計讓您可以創建滿足您和您的客戶所需求的應用程序。（我們領先的甘特圖控件VARCHART XGantt可用于.NET，ActiveX和ASP.NET應用程序。）除此之外，同時還具有一個穩定可靠的甘特圖工具，在編寫第一行代碼之前，您就可以知道是否可以滿足客戶的需求。

點擊下載VARCHART XGantt免費版

本文主要介紹如何通過VARCHART XGantt計算活動結束日期（.NET版），想要嘗試一下的朋友們可以按照教程內容操作哦~

保存結束日期的表列仍為空。可以使用VARCHART XGantt中包含的日歷從“開始”和“持續時間”字段計算活動的結束。

在默認日歷中，工作日（周一至周五）預先定義為活動時間，周末（周六和周日）定義為非活動時間。

您可以通過灰色背景識別圖中的非活動時間。可以通過在“節點”屬性頁面上停用“使用日歷”選項節點來關閉日歷。

請注意使用時和不使用日歷時的計算差異：

活動從周五開始并持續3天，如果日歷被激活，活動將在星期二結束。沒有日歷，活動將在周日結束。

可以使用對象VcCalendar的AddDuration（...）方法計算結束日期。這需要每個活動的開始和持續時間。可以通過索引訪問這些字段。在通過方法set_DataField（...）設置結束日期之后，需要調用VcNode的Update（）方法來顯示修改。

示例代碼VB.NET

Dim tmpCal As VcCalendar
Dim tmpDate As Date
Set tmpCal = VcGantt1.CalendarCollection.Active
tmpDate = tmpCalendar.AddDuration(node.DataField(2), node.DataField(4))
node.DataField(3) = tmpDate
node.Update()

示例代碼C＃

VcCalendar tmpCal = vcGantt1.CalendarCollection.Active;
DateTime tmpDate = tmpCal.AddDuration((DateTime)node.get_DataField(2),
 Convert.ToInt32(node.get_DataField(4)));
node.set_DataField(3, tmpDate);
node.Update();

通過鼠標交互創建或修改的活動的開始和結束日期將自動置于活動時間。

相反，API或編輯對話框設置的日期可以放置在非工作時間。

通過計算生成的日期始終處于工作時間。

為了確保API設置的日期處于工作時間，需要從結束日期和活動持續時間計算開始日期。

示例代碼VB.NET

tmpDate = tmpCal.AddDuration(node.DataField(3),
 (-1) * node.DataField(4))
node.DataField(2) = tmpDate

示例代碼C＃

tmpDate = tmpCal.AddDuration((DateTime)node.get_DataField(3),(-1) *
Convert.ToInt32(node.get_DataField(4)));
node.set_DataField(2, tmpDate);

為了保持數據的一致性，丟失或負的持續時間應視為不正確，并重置為0。如果缺少開始日期，則無法計算結束日期。代碼在名為SetNodeEndDate（...）的單獨方法中恢復。

示例代碼VB.NET

Private Sub SetNodeEndDate(ByVal node As VcNode)
 'Avoid empty duration or negative duration
 If node.DataField(4) = "" Or node.DataField(4) < 0 Then
 node.DataField(4) = "0"
 End If
 'Start date empty then end date should also be empty
 If node.DataField(2) = "31.12.1899 00:00:00" Then
 node.DataField(3) = ""
 Else
 'Precondition is property page nodes
 '"Assign calendar to nodes" must be true
 Dim tmpCal As VcCalendar
 tmpCal = VcGantt1.CalendarCollection.Active
 Dim tmpDate As DateTime
 tmpDate = tmpCal.AddDuration(node.DataField(2), node.DataField(4))
 node.DataField(3) = tmpDate
 'Start date only in active times 
tmpDate = tmpCal.AddDuration(node.DataField(3),
 (-1) * node.DataField(4))
 node.DataField(2) = tmpDate
 node.Update()
 End If
End Sub

示例代碼C＃

private void SetNodeEndDate(VcNode node)
 {
 // Avoid empty duration or negative duration
 if ((string) node.get_DataField(4) == "" ||
 Convert.ToInt32(node.get_DataField(4)) < 0)
 node.set_DataField(4,"0");

 // Start Date empty then end date should also be empty
 if (node.get_DataField(2).ToString() == "31.12.1899 00:00:00")
 node.set_DataField(3,"");
 else
 {
 // Precondition in property page nodes
 // "Assign calendar to nodes" must be true
 VcCalendar tmpCal = vcGantt1.CalendarCollection.Active;

 DateTime tmpDate = tmpCal.AddDuration(
 (DateTime)node.get_DataField(2),
 Convert.ToInt32(node.get_DataField(4)));
 node.set_DataField(3, tmpDate);

 // start date only in active times
 tmpDate = tmpCal.AddDuration((DateTime)node.get_DataField(3),
 (-1) * Convert.ToInt32(node.get_DataField(4)));
 node.set_DataField(2, tmpDate);
 node.Update();
 }
 }

需要計算日期：

1、活動結束后

2、通過數據編輯對話框或就地編輯器修改日期或持續時間之后

3、API修改活動值后

然而，在通過鼠標交互進行修改之后，不需要啟動計算，因為在這種情況下，將自動執行內部計算。

可以通過VcGantt對象的屬性NodeCollection來設置包括所有節點的計算循環。它的代碼將被添加到事件Form1_Load（...）的末尾。

示例代碼VB.NET

'Calculate end date for all nodes
Dim node As VcNode
For Each node In VcGantt1.NodeCollection
 SetNodeEndDate node
Next

示例代碼C＃

// Calculate end date for all nodes
foreach (VcNode node in vcGantt1.NodeCollection)
 {
 SetNodeEndDate(node);
 }

VcNodeModified事件可以拾取用戶引起的數據更改。添加的方法調用將計算結束日期。

示例代碼VB.NET

Private Sub VcGantt1_VcNodeModified(ByVal sender As Object, ByVal e As
NETRONIC.XGantt.VcNodeModifiedEventArgs) Handles VcGantt1.VcNodeModified
 SetNodeEndDate(e.Node)
End Sub

示例代碼C＃

private void vcGantt1_VcNodeModified(object sender,
NETRONIC.XGantt.VcNodeModifiedEventArgs e)
 {
 SetNodeEndDate(e.Node);
 }

如果API更改了數據值，則必須顯式調用方法SetNodeEndDate（...）。

想要購買VARCHART XGantt正版授權，或了解更多產品信息請點擊

掃描關注慧聚IT微信公眾號，及時獲取最新動態及最新資訊