DataSourcePicker Class

Description

The DataSourcePicker class provides a dialog that can be used to select objects from the DataSourceComponent.  It provides much of the functionality offered by the ObjectPicker dialog, but with added features and improved performance.

The following image gives an example of the appearance of the DataSourcePicker dialog.  Click on various parts of the image to get a description of the function of that aspect of the dialog.

When using this dialog to perform a search in the "Name" column, the search result may contain some objects for which the name does not contain the search string.  Objects contained in a category whose name contains the search string will also be returned.  

More information about the usage and functionality of the DataSourcePicker dialog can be found in the Getting Started Guide.

 

Public Constructors

Constructor

Description

DataSourcePicker

Creates a new instance of the DataSourcePicker class

 

Public Properties

Property

Description

Caption

Gets and sets the caption displayed on the dialog

Colors

Sets the colors that the editable and non-editable data source objects are displayed in.

ParentHandle

Specifies the window that acts as the parent to this dialog

 

Public Methods

Method

Description

Show

Displays the DataSourcePicker as a modal dialog

 

Public Events

Event

Description

OnPickerObjectTest

This event can be used to filter the objects that are displayed in the DataSourcePicker