The PI-MDBTree control is a general purpose PI Module Database viewer/interface component, which applications can utilize for user interactions: module selection; search; copy; with the module database
The visual components of the PI-MDBTree control consists of a tree-view and query date controls.
The contained tree-view is a standard MS tree-view control that is used to present the Module Database in a hierarchical manner. The PI-MDBTree control provides numerous properties and methods that allow the users to manipulate the style and behavior of the tree-view. Additionally, users can control what types of MDB objects are visible in the tree.
The public properties that control the view style, object visibility and rudimentary behavior are exposed to interactive users as context menus. These menus can be activated by right-clicking the background of the tree-view or by pressing ALT M. An application may choose to programmatically disable these menus if users should not, or are not allowed to, alter the settings.
Each different MDB object type, i.e. Server, PIModule, PIAlias and PIProperty and the additional, synthesized collection types (modules, aliases and properties) have their own context menus. User can invoke a menu by right-clicking a specific tree node or by ALT F10 if using the keyboard. These menus can be used to copy the selected node(s) or view its properties in a separate dialog window.
The users can manipulate the "Query Date" property that controls the current MDB query date. Modules can have different values at a different times. The Query Date is used to specify the desired value. Users can enter the query date in text format (see VB Format function for details) or by selecting it from a "date/time picker" dialog. This setting affects all servers and modules displayed. The host/container application may choose to hide these controls from the user.
The MDBTree implements a rudimentary copy/paste and drag/drop functionality. The data that is copied to the clipboard consists of the currently selected tree nodes in 3 formats: the node/object names; full pathnames; and persistence strings. The object names, a standard text format, can be pasted/dropped onto most, text based, controls. The other two formats require programmatic support from the target application. The MDBTree control is not a target for these operations
What the control looks like in the Visual Basic toolbox.
What the control looks like in an application.
When to Use the MDBTree Control
This control allows a user to view the Module database as a hierarchical tree. The control allows selection of a module, an alias, a property or a heading for use as context in an application.