VARCHART XGantt入门教程

甘特图（Xgantt）从1998年的第一个商用版本开始就致力于计划编制和项目管理方面控件的研究和开发，经过20多年的积累和沉淀，目前可为软件开发商和最终用户提供最顶级的计划编制和项目管理的控件产品，帮助用户快速的整合项目管理软件所需的甘特图，网络图，资源柱状图，日程日历，资源调度等功能模块，并提供全方位的支持和服务。

VARCHART XGantt是一款功能强大的甘特图控件，其模块化的设计让您可以创建满足需要的应用程序。XGantt可用于.NET，ActiveX和ASP.NET应用程序，可以快速、简单地集成到您的应用程序中，帮助您识别性能瓶颈、避免延迟以及高效利用资源，使复杂数据变得更加容易理解。

示例：教程项目1

作为代码示例的开发环境，我们向上使用Visual Studio .NET 2010。我们的第一个样本将显示以下结果：

我们的示例集合包括示例教程项目1，该示例项目演示了VARCHART XGantt的内置交互，并让您轻松理解我们博客系列中描述的步骤。

现在，我们出发！

将甘特图控件放置在窗体上

对Visual Studio 2010用户的提醒： 正如我们在入门博客＃1中已经提到的那样，在将甘特图控件拖到窗体之前， 请记住在应用程序中将目标框架从  .NET Framework Client Profile  更改为  .NET Framework 4 。  设置 （C＃）或  高级编译器设置 （VB），因为前者缺少System.Design.dll，这是设计时属性页所必需的。如果您不更改框架，则在尝试将控件拖到窗体上时会弹出错误消息。

要将VARCHART XGantt控件放置在表单上，请xgantt_icon_toolbox 在工具箱中选择其图标，并在表单中您希望其出现的位置绘制一个框架。

如果希望在运行时将VARCHART Windows Forms控件的底部和右侧调整为窗口的完整大小，请使用控件的anchor或dock属性。

提示：

使用数据类型和“枚举”元素时，程序开头的“名称空间”指令将为您节省详细的参考指示。

VB: Imports NETRONIC.XGantt
C#: using NETRONIC.XGantt;
VcNodeCollection而不是NETRONIC.XGantt.VcNodeCollection。

提供数据

为了显示活动和链接，VARCHART XGantt需要提供数据。默认情况下，两个表用于必要的通信：

• NodeTable（也称为Maindata）
• LinkTable（也称为“关系”）

在表单中放置VARCHART XGantt时，已经设置了基本字段。

Maindata数据表的字段：

关系数据表的字段

所需的其他字段需要手动定义。您可以在设计时通过对话框“ 管理数据表”（下部）来执行此操作，或者在运行时通过对象VcDataTableFieldCollection的Add（...）方法来执行此操作。

如果需要的表多于默认定义的表，则可以在属性页常规上单击启用的扩展数据表后，在“ 管理数据表 ”对话框的上部创建它们。

该方法DataRecordByID（）的VcDataRecordCollection允许通过主键来快速找到对象。

为了使活动和链接在我们的入门示例中可见，您需要首先在数据表中输入一些记录。

这可以通过使用该方法来进行添加（...）对象类型的VcDataRecordCollection。该方法EndLoading完成对对应的图表上构成的数据输入。为此，请在表单的Load事件中输入以下代码行。

示例代码C＃

vcGantt1.ExtendedDataTablesEnabled = true;

    VcDataTable dataTable = vcGantt1.DataTableCollection.DataTableByName("Maindata");

   VcDataRecordCollection dataRecCltn = dataTable.DataRecordCollection;     

         

         dataRecCltn.Add（“ 1;节点1; 04.05.2015 ;; 5 ;;组1;组A;”）;

         dataRecCltn.Add（“ 2; Node 2; 11.05.2015 ;; 5 ;; Group 1; Group A;”）;

         dataRecCltn.Add（“ 3;节点3; 18.05.2015 ;; 5 ;;组1;组B;”）;

   dataTable = vcGantt1.DataTableCollection.DataTableByName（“ Relations”）;

   dataRecCltn = dataTable.DataRecordCollection;

   dataRecCltn.Add("1;1;2");

   dataRecCltn.Add("2;2;3");

  vcGantt1.EndLoading();

记录中的值用分号分隔。字段的顺序必须与数据定义中字段的顺序相对应。新记录必须具有不为空的明确标识。记录中的日期必须与数据定义表中的DateFormat定义相对应。持续时间的解释取决于时间单位的设置。它已预设为days，您可以在“ 常规”属性页面上对其进行修改。

为表和“ 常规”属性页上的每个对话框一致地定义了“ 日期”输出格式。

从CSV文件加载数据

或者，您也可以从CSV文件加载数据。该文件的结构必须与以下方案对应：
**** Maindata ****

1;Node 1;04.05.2015;;5;;Group 1;Group A;
2;Node 2;11.05.2015;;5;;Group 1;Group A;
3;Node 3;18.05.2015;;5;;Group 1;Group B;
**** Relations ****
1;1;2;
2;2;3;

每个记录都有其自己的行。这些行的内容与对象类型VcDataRecordCollection的方法Add（...）传递的参数相对应。

首先列出Maindata数据表的记录，然后是Relations数据表的记录。使用****表名****标记记录组的开头。

如果您使用名称intro.csv例如保存了这种文件，则可以按以下方式导入数据：

示例代码C＃

vcGantt1.Load(@"c:\intro.csv");

指定表示的时间段

到现在为止，您不会看到任何活动，因为时间比例尚未调整为相应的时间段。时间刻度的显示范围可以通过属性TimeScaleStart和TimeScaleEnd定义，也可以通过对象VcGantt的OptimizeTimeScaleStartEnd（...）方法从数据中确定。

示例代码C＃

private void Form1_Load(object sender, System.EventArgs e)

{
    vcGantt1.ExtendedDataTablesEnabled = true;
   VcDataTable dataTable = vcGantt1.DataTableCollection.DataTableByName("Maindata");

   VcDataRecordCollection dataRecCltn = dataTable.DataRecordCollection;     

         dataRecCltn.Add（“ 1;节点1; 04.05.2015 ;; 5 ;; Group 1; Group A;” ）;
         dataRecCltn.Add（“ 2;节点2; 11.05.2015 ;; 5 ;; Group 1; Group A;” ）;
         dataRecCltn.Add（“ 3;节点3; 18.05.2015 ;; 5 ;; Group 1; Group B;” ）;
 

   dataTable = vcGantt1.DataTableCollection.DataTableByName("Relations");

   dataRecCltn = dataTable.DataRecordCollection;

   dataRecCltn.Add("1;1;2");

   dataRecCltn.Add("2;2;3");

   vcGantt1.EndLoading();

   vcGantt1.OptimizeTimeScaleStartEnd(3);

}

如果您现在运行程序，结果应如下图所示。

计算结束日期

包含结束日期的表格列仍为空。可以使用VARCHART XGantt中包含的日历从“ 开始”和“ 持续时间 ”字段中计算活动的结束时间。

在默认日历中，将工作日（周一至周五）预定义为活动时间，将周末（周六和周日）定义为非活动时间。

您可以通过灰色背景识别图中的非活动时间。通过禁用“ 节点”属性页面上的“ 节点使用日历 ”选项，可以关闭日历。

请注意使用和不使用日历的计算差异：

如果激活了日历，则从星期五开始并持续3天的活动将在星期二结束。没有日历，活动将在周日结束。

可以通过使用对象VcCalendar的AddDuration（...）方法来计算结束日期。这需要每个活动的开始和持续时间。可以通过它们的索引访问这些字段。具有由该方法设置的结束日期之后set_DataField（...），该方法更新（）的VcNode需要调用要显示的修改。

示例代码C＃

foreach (VcNode node in vcGantt1.NodeCollection)

         {

            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设置的日期放入工作时间，需要从结束日期和活动持续时间计算开始日期。

示例代码C＃

tmpDate = tmpCal.AddDuration((DateTime)node.get_DataField(3),

               (-1) * Convert.ToInt32(node.get_DataField(4)));

node.set_DataField(2, tmpDate);

为了保持数据的一致性，应将缺失的持续时间或缺失的持续时间视为不正确的，并将其重置为0。如果缺少开始日期，则无法计算结束日期。该代码在名为SetNodeEndDate（...）的单独方法中恢复。

示例代码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"); // If the start date is empty then the end date should also be empty if (node.get_DataField(2).ToString() == "31.12.1899 00:00:00") node.set_DataField(3,""); else { // "Assign calendar to nodes" on the Nodes property page has to be checked 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 timespans 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修改活动值之后

但是，通过鼠标交互进行修改后，无需启动计算，因为在这种情况下，将自动执行内部计算。

甲计算环路，它包括所有的节点都可以通过属性设置NodeCollection所述的VcGantt对象。它的代码将添加到事件Form1_Load（...）的末尾。

示例代码C＃

// Calculate end date for all nodes 

foreach (VcNode node in vcGantt1.NodeCollection)

   SetNodeEndDate(node);

由用户引起的数据更改可以通过事件VcNodeModifiedEx获取。添加的方法调用将计算结束日期。

示例代码C＃

private void vcGantt1_VcNodeModifiedEx(object sender, VcNodeModifiedExEventArgs e)

      {

         switch (e.ModificationType)

         {

            case VcModificationTypes.vcAnything:

               //Node modified by Inplace Editor

               SetNodeEndDate(e.Node);

               break;

            default:

               break;

         }

      }

如果API更改了数据值，则必须显式调用SetNodeEndDate（...）方法。

下一步
您想继续对应用程序进行编程，而不能等待我们博客系列的下一个序列？我们通过提供非常全面的开发人员手册为您提供支持  ，我们强烈建议使用。除此之外，您还可以下载我们的免费白皮书，其中提供11个最佳实践提示，包括代码片段：

 

本文章转载自【慧都科技】。欢迎任何形式的转载，但请务必注明出处、不得修改原文相关链接，尊重他人劳动成果