DlhSoft Hierarchical Data Library (Windows® Forms) Documentation

Hierarchical Data Library (Windows® Forms) contains Windows® client components such as DataTreeGridView control.

The DataTreeGridView control is used to display and update a list of node items.

The control requires setting the input item collection to manage through DataSource property.

The developer may control how the business logic is applied to the node items by setting or clearing values for data member identifying properties such as IndentLevelMember, and IsExpandedMember.

The custom node item type should provide properties similar to those listed below, and their names should be set to the appropriate data member identifying properties:

· IndentLevel: The hierarchy is based on the indentation level values of the nodes, so that a node with a lower index in the collection and having a specific indentation level will become the parent node for the nodes with a higher index in the collection and having an increased indentation level;

· IsExpanded: If a parent node is expanded its child nodes become visible. If a parent node is collapsed its child nodes become invisible.

Structure

The root assemblies and types that the library includes are listed below:

DlhSoft.HierarchicalDataControlLibrary assembly:

· DataTreeGridView control (DlhSoft.HierarchicalDataControlLibrary namespace).

Get Started

To add references to the library assemblies within your solution project using Visual Studio®, please follow these steps:

· Select your project in Solution Explorer;

· Use the Add Reference command from the Project menu to open the Add Reference dialog window;

· Locate and select the assemblies you want to reference within the .NET tab of the Add Reference dialog window;

· Click OK to close the dialog window. The assemblies are referenced in your project.

To be able to specify the referenced type names in your main source code without any DlhSoft namespace prefix, make sure you also include using or Imports directives for the appropriate namespaces in each of the referencing source code files.

To add the library Windows® Forms controls as reference shortcuts in a Toolbox group within Visual Studio®, and to create control instances in the Windows® Forms user interface designer using the Toolbox, please follow these steps:

· Open the Windows® Forms user interface designer for a form that you want to add controls to;

· Open the Toolbox and display its context menu;

· Use the Add Tab command from the context menu to create a new group, such as DlhSoft, if the group you want to add the controls to doesn't already exist;

· Select the tab you want to add the Windows® Forms controls to and display its context menu;

· Use the Choose Items command from the context menu to open the Choose Toolbox Items dialog window;

· Locate and select the controls you want to add within the .NET Framework Components tab of the Choose Toolbox Items dialog window;

· Click OK to close the dialog window. The controls are added to your Toolbox group;

· Double click a control reference shortcut icon from the Toolbox group to create an instance of that control within your form that is open in the Windows® Forms user interface designer.