| 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. |