TIB_DataSource Object
Properties Methods Events

Unit
IB_Components

Declaration
TIB_DataSource = class(TIB_StatementLink)

Description
This component is used in order to provide a reference to an IB_Dataset component.

It is how data aware controls are attached to a dataset.

It also serves as a means to provide relationships between datasets. This is used by the KeySource and MasterSource properties of the TIB_Dataset class.

Introduced Public Properties
_DataLinkCount  Number of DataLinks associated to this component.
AllowFocus  This property determines whether or not the session should consider this DataSource focused if its SetFocus method is called.
AnnounceFocus  This property determines if when a DataSource receives the current focus the session should announce that a new DataSource has become focused.
AutoEdit  This property determins whether or not a data aware control can place the dataset into dssEdit state if not already in that state.
AutoInsert  This property determins whether or not a data aware control can place the dataset into dssInsert state if not already in that state.
Bof  This property returns whether the associated dataset is at Bof or not.
CanModify  This property returns whether or not the dataset contents can be modified.
ControlsDisabledLevel  This property tells if this component will be announcing state and datachange events comming from the parent dataset.
DataLinkCount  Number of DataLinks that are associated to this DataSource.
Dataset  This is the reference to the Dataset used by this component.
Enabled  Turns off the announcement of data and state change event notifications.
Eof  This property returns whether the associated dataset is at Eof or not.
NeedToPost  This property returns whether or not the associated dataset is in a state that needs to be posted or not.
ReadOnly  Determines if the controls attached through this component should be ReadOnly.
RowState  Current state of the Fields.RowState of the associated dataset.
State  Returns the current state of the associated dataset.
StatementType  Returns the statement type that was prepared in the associated dataset.

Introduced Public Methods
Create
Destroy
DisableControls   Method to cache up any state and datachange notifications.
DisableInterface   Similar to DisableControls but calling this only disables user interface controls.
Edit   Method used to attempt to put the dataset into dssEdit state in order for a control to allow its data to be modified.
EnableControls   Method to dispatch cached up state and datachange notifications.
EnableInterface   Method to restore enabled status of interface controls.
Insert   Method used to attempt to put the dataset into dssInsert state in order to allow data to be inserted.
IsLinkedTo   Method that check for a circular relationship with a dataset.
Modify   General request made to see if the dataset can go into a state that will allow a general chage to data in a data aware control.
Modifying   Method that returns whether the dataset is in a state that allows data to be modified.
Reset   This method will cause all data aware controls to be reset to whatever the current data values are.
SetFocus   This method causes this component to become the currently focused TIB_DataSource component for the current Session.

Introduced Public Events
AfterAssignment  This event is fired after the Dataset property has been changed to a new value.
BeforeAssignment  This event is fired before the Dataset property is about to be changed to a new value.
OnDataChange  When the dataset announces a data change event this event gets fired.
OnGainFocus  When this component gains the focus this event is fired.
OnLoseFocus  When this component loses the focus this event is fired.
OnStateChanged  When the dataset announces a state change event this event gets fired.
OnUpdateData  When the dataset announces an update data event this event gets fired.