Getting Started with the ActiveGanttCSN Gantt Chart Scheduler Component

Monday, September 19, 2011

ActiveGanttCSN is a Gantt Chart / Scheduler component designed for Windows Forms and C#. This is a complete tutorial that describes how to get started with the ActiveGanttCSN Component. It covers installing the component, as well as creating a very simple Windows Forms application with ActiveGanttCSN.

1. ActiveGanttCSN Requirements

2. Downloading the ActiveGanttCSN component.

3. Installing the ActiveGanttCSN component.

4. Examining the files created by the ActiveGanttCSN install program.

      4.1. The ActiveGanttCSN HTML Help Shortcut.

      4.2. The ActiveGanttCSN Demo Project Shortcut.

      4.3. The ActiveGanttCSN Demo Executable Shortcut.

5. How to create a simple Windows Forms application using the ActiveGanttCSN component.

1. ActiveGanttCSN Requirements.

For developing applications with ActiveGanttCSN:

For deploying your applications that use ActiveGanttCSN:


2. Downloading the ActiveGanttCSN component.

The latest version of the ActiveGanttCSN component is accessible from this page in our website:

Select ActiveGanttCSN from the drop down list and press the Download Now button, select the destination directory (this procedures varies according to the type of browser being used) and begin downloading.

The ActiveGanttCSN install program is packaged in a compressed .zip file. The file names are structured according to the following convention:

3. Installing the ActiveGanttCSN component.

Downloading will have left you with a file named AGCSN_NETXX_X_X_X(D/R).zip.

The ActiveGanttCSN install program does not contain any spyware, viruses or useless third party tools.


This .zip file contains two files: the .msi install package and a readme file in .rtf format. The readme file can be viewed using Microsoft Word or Word Pad.


Extract both files from the .zip file


Double click on the AGCSN_NETXX_X_X_X(D/R).msi file to begin the install process. In Windows Vista and above you will get a security prompt. Click on the Yes button to continue.


You will be taken to the welcome screen of the ActiveGanttCSN installation program. Click on the Next button.


You will then be prompted for the installation directory. Click on the Next button.


The install program will ask for your confirmation before beginning to install ActiveGanttCSN, click on the Next button.


Another security screen will ask you if you want the ActiveGanttCSN install program to copy software onto your computer. Click on the Yes button.


After the ActiveGanttCSN installation program finishes copying files to your computer, a browser window will open which contains all the above setup instructions plus any version specific information that might be of use.


Click on the Close button to terminate the installation of ActiveGanttCSN.


The ActiveGanttCSN component can now be uninstalled using the control panel. Always use the control panel application to uninstall ActiveGanttCSN. After uninstalling the ActiveGanttCSN component you can also erase the "C:\Program Files\Boötes Systems SAS\ActiveGanttCSN\" directory for a complete uninstall.

You must completely uninstall the ActiveGanttCSN component when upgrading to a more recent version or when switching from the Trial to the Release version.

4. Examining the files created by the ActiveGanttCSN install program.

On a default install of the ActiveGanttCSN component, all files will be copied to the "C:\Program Files\Boötes Systems SAS\ActiveGanttCSN\" directory.

The most important files in this directory are the following:

Path File Description
C:\Program Files\Boötes Systems SAS\ActiveGanttCSN\ AGCSN_TR.sln The Visual Studio Solution File
C:\Program Files\Boötes Systems SAS\ActiveGanttCSN\AGCSNCON\ AGCSNCON.csproj The example's C# project file
C:\Program Files\Boötes Systems SAS\ActiveGanttCSN\AGCSNCON\bin\ AGCSNCON.exe The example's executable file
C:\Program Files\Boötes Systems SAS\ActiveGanttCSN\AGCSNCON\AGCSN\ AGCSN.dll The ActiveGanttCSN Windows Forms Control
C:\Program Files\Boötes Systems SAS\ActiveGanttCSN\Additional Files\ AGCSN.chm The ActiveGanttCSN compiled HTML Help file


The install program will generate two shortcuts on the desktop, ActiveGanttCSN Demo Project is a shortcut to the AGCSN_TR.sln file and ActiveGanttCSN Demo Executable is a shortcut to the AGCSNCON.exe file.


The install program will also create an ActiveGanttCSN menu in Programs. This menu contains copies of the shortcuts installed on the desktop, plus a shortcut to the ActiveGanttCSN help file and a shortcut to the ReadMe file.

4.1. The ActiveGanttCSN HTML Help Shortcut.


Clicking on the ActiveGanttCSN Help shortcut in the ActiveGanttCSN menu will bring up the local HTML help file for the component.


This help file is also available online from this link:

4.2. The ActiveGanttCSN Demo Project Shortcut.

Clicking on the ActiveGanttCSN Demo Project shortcut will generate an elevated permissions prompt in the operating system. Click on the Restart this application under different credentials option.


You will then get a User Access Control prompt. Click on the Yes button.


You will then get the AGCSN_TR.sln Visual Studio solution file.

The Visual Studio solution file contains all the source code for the ActiveGanttCSN example. You can press the F5 key to begin debuging.

4.3. The ActiveGanttCSN Demo Executable Shortcut.


Clicking on the ActiveGanttCSN Demo Executable will bring up this screen.

The ActiveGanttCSN Demo has two main examples:

Both examples have three modes:

Additionally the ActiveGanttCSN Demo has three examples on how to read Microsoft Project 2003, 2007 and 2010 XML files.

All the code used to generate the demo is included in the AGCSN_TR.sln Visual Studio Solution.

*Microsoft has not released and does not intend to release an ODBC driver for Access databases for x64 systems and therefore, the Access data source mode is not available when running the demo in 64 bit mode on a 64 bit system.

5. How to create a simple Windows Forms application using the ActiveGanttCSN component.

Start a new instance of Visual Studio.

Select   File -> New -> Project....


In the New Project dialog select   Installed Templates -> C# -> Windows -> Windows Forms Application. Leave the solution's name as the default: WindowsFormsApplication1. The solution's name is not important for this example.


The template will generate a Windows Forms application with a single Windows Form named Form1.


Select the Toolbox tab on left. Right click on any control and from the drop down menu select the Choose Items... option.


The Choose Toolbox Items dialog will pop-up. Click on the Browse button in the .NET Framework Components tab.


Select the ActiveGanttCSN component (AGCSN.dll). In a default installation it will be located in "C:\Program Files\Boötes Systems SAS\ActiveGanttCSN\AGCSNCON\AGCSN\AGCSN.dll". Then click on the Open button.


The ActiveGanttCSNCtl is now included in the Choose Toolbox Items dialog. Click on the OK button to exit the dialog.


After exiting the Choose Toolbox Items dialog, the ActiveGanttCSNCtl component will now be present in the Toolbox.


Resize Form1 to an appropriate size, the default is too small. Then drag the ActiveGanttCSNCtl from the Toolbox onto Form1 and resize the ActiveGanttCSN accordingly.

In the trial version of the ActiveGanttCSN control you will be presented with a nag screen, click the OK button to continue.

In the trial version of the component the nag screen will pop-up when:

  • You are adding a new control from the Toolbox onto a Form.
  • You are opening a Form in design view that contains an ActiveGanttCSN control.
  • You are building the project.
  • You are opening a Form during runtime that contains the ActiveGanttCSN control.


Press the F5 key to begin debugging or alternatively you can go to the  Debug -> Start Debugging  menu.


At this time you will only have an ActiveGanttCSN control with no functionality. The watermark on the lower right hand side will only be present in the trial version of the ActiveGanttCSN component.

Close the form to exit debugging. You will again have Form1 in design view. Double click on any empty space (avoid double clicking on the ActiveGanttCSNCtl) to add code for the form's Form1_Load event.

        private void Form1_Load(object sender, EventArgs e)
            int i;
            activeGanttCSNCtl1.Columns.Add("Column 1", "", 125, "");
            activeGanttCSNCtl1.Columns.Add("Column 2", "", 100, "");
            for (i = 1; i <= 10; i++)
                activeGanttCSNCtl1.Rows.Add("K" + i.ToString());

The above code will create two Columns and ten empty Rows. Notice that every Row has to be identified by a unique key, "K1", "K2", K3", etc. Press the F5 key to begin debugging.


Press the F5 key to begin debugging.


You can add Task objects by clicking and dragging over any Row in the Client Area of the ActiveGanttCSN control.

The examples included in the demo cover almost every piece of functionality present in the ActiveGanttCSN component, but if you need further assistance please read our ActiveGantt support options. Important: if you are sending an e-mail you have to specify that you are referring to the ActiveGanttCSN component, otherwise you will inevitably experience delays in having your query answered.


All trademarks are property of their respective holders, and are only used to directly describe the products and services being provided. Their use in no way indicates any relationship or endorsement between The Source Code Store LLC and the holders of said trademarks.