DlhSoft Hierarchical Data Library 2.0 Documentation

Hierarchical Data Library 2.0 contains hierarchical data related Windows client components such as the DataTreeGridView control.

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

The control class 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 class (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 class within your form that is open in the Windows Forms user interface designer.

Sample Applications

View the source code of the sample applications listed below to easily and/or better understand how to use the types included within the library in your own applications.

Note that each sample application is provided as an archived folder; you should extract the archived content of each sample application that you want to view in your Visual Studio Projects folder, and open it by activating the appropriate Visual Studio project file from the extracted folder; unless otherwise specified the source code of the sample applications has been developed using the C# programming language:

·         Get Started sample: Shows how you can use the DataTreeGridView control.

License Management

To purchase a license files for this product after you have set it up on your computer, please use the Purchase License page from the DlhSoft Web site. You will receive the purchased license files and their associated installation information on your e-mail.

Reference

If you need detailed development information about the types and members, such as methods, properties, and events included in this product after you have set it up on your computer, please select Reference from the product menu available in the Start menu.

Questions and Answers

If you need to ask a question or to report an issue regarding the product, please contact us using the Support page of the DlhSoft Web site.