RDTA.PickDP.Extensions Library Overview

The Extensions library contains the Pick Data Provider classes, controls, and components that automate the movement of data between visual components and the back-end database. These components can work with any .NET visual control as well as the controls provided by the Pick Data Provider. The Extensions library makes use of the RDTA.PickDP.Connector library to present Pick data using either a record set familiar to hierarchical database programmers or Pick Items which are familiar to Pick programmers.

Key classes

Class	Description
Cell	Represents one or more values in a row in a column of data.
Column	Represents a column of data in a table.
connection	Generally placed on the FormMDI to provide access to a Pick Data Provider server. Defines the connection to the server.
DBDataBinder	Placed on a form that uses the Pick Data Provider’s ability to use properties to link visual components to the back-end database. The DBDataBinder supports column and control binding: Column bindings are used for visual components which are aware of cells within columns (DBGrid). Control bindings are used for cells that are not aware of cells within columns.
DBGridBinder	Placed on a form that uses a DBGrid to bind the columns on a form to the table.
table	Placed on a form that needs to access a database table. Defines a table accessed through a connection.

Object Reference Model

In this model, classes that extend Control can also be placed on the Form and controlled through the ControlBinder.

Class Inheritance Model

The RDTA.PickDP.Extensions library includes these classes, controls, and interfaces:

Classes

Cell	Represents a single row column intersection in a DBGrid.
Column	Run-time object representing a column in a grid. Not a design-time component.
ColumnBinder	Binds grid columns with a multivalue table.
connItemCancelEvent	Event handler for the connItem Object.
connItemEvent	Creates a new event handler for the connItem Object.
ControlBinder	Binds form controls with the data in a table. onProcess events are fired when the data is processed.
DeleteRowEvent	Creates a handler for row deletion events.
EnterCellEvent	Creates an event handler for EnterCell events.
InsertRowEvent	Creates an event handler for InsertRow events.
LeaveCellEvent	Creates an event handler for LeaveCell events.
lockType	Enumerates the different lock types.
pickPoint
reflection	Used by Pick Data Provider templates to open the connections and tables associated with the form.

Controls

connection	Defines the connection to the database server.
DBCheckBox	Extended check box contained inside the panelCheck control.
DBCombo	Extension of the Forms.ComboBox control. All control items are automatically maintained from the visual4mv environment. The DBComboBox is a collection of connValuePair Objects. Each connValuePair Object represent an Item_Id in the table as internal code and a String with the value of the Item defined as external Value.
DBDataBinder	Binds the fields in a table to the controls in a form.
DBGrid	Maps a multivalued item to a grid. Each grid column can be assigned to an attribute in the item.
DBGridBinder	Binds DBGrid columns to fields in a table.
DBGridBinding	Binds a DBGrid column to a field in a table.
DBListBox	Extension of the Forms.ListBox control. All control items are automatically maintained from the visual4mv environment. The DBListBox is a collection of connValuePair Objects. Each connValuePair Object represents an Item_Id in the table as internal code and a String with the value of the Item defined as external Value.
DBRadioButton	This is an extended RadioButton included as a control inside the panelRadio control.
EditNum	Edit box for numeric values.
panelCheck	Combines the results of each selected DBCheckBox in the panel into one column. DBCheckBoxes are optionally placed into a panelCheck control. When the panelCheck is processed, the activated value of each selected DBCheckBox (that is, the check box is checked) is saved. When working with a panelCheck, the panelChecks (not the individual DBCheckBoxes in the panelCheck) are bound.
panelRadio	Combines the results of each selected DBRadioButton in the panel into one column. DBRadioButtons are optionally placed into a panelRadio control. When the panelRadio is processed, the activated value of the selected DBRadioButton is saved. When working with a panelRadio, the panelRadios (not the individual DBRadioButtons in the panelRadio) are bound.
table	Represents a single table in a database.

Event Handlers

DBGrid.DeleteRowEventHandler	Defines the delegate and registration point for processing DeleteRowEvents.
DBGrid.EnterCellEventHandler	Defines the delegate and registration point for processing EnterCellEvents.
DBGrid.InsertRowEventHandler	Defines the delegate and registration point for processing InsertRowEvents.
DBGrid.LeaveCellEventHandler	Defines the delegate and registration point for processing LeaveCellEvents.
table.connItemCancelEventHandler	Defines the delegate and registration point for processing connItemCancelEvents.
table.connItemEventHandler	Defines the delegate and registration point for processing connItemEvents.