comp • gb.db.form • datasource

DataSource (gb.db.form)

DataSource is a Container that provides data from a database to all its children and grand-children recursively: It uses its Table and Filter properties and an open Connection to make a Result object. From this Result, it fills its children controls.

The database is defined by the Connection property.

This class inherits Panel in gb.qt4.
This class is
Create a new DataSource control.
creatable
.
This class acts like a
Return the value of the Key field of the current record.
read-only
array.

Properties

Methods Events
Returns or sets the action string associated with the control.
Action  
Returns or sets how this container arrange its children controls.
Arrangement  
Return or set if the sort is ascending.
Ascending  
Indicates that the container automatically resizes to the size of its contents.
AutoResize  
Returns or sets the background color used by the control.
Background  
Returns or sets the border type of the control.
Border  
Returns a collection of each control included in the container.
Children  
A synonymous for the ClientHeight property.
ClientH  
Returns the height of the area containing the controls.
ClientHeight  
A synonymous for the ClientWidth property.
ClientW  
Returns the width of the area containing the controls.
ClientWidth  
Returns the position of the top border of the area containing the controls.
ClientX  
Returns the position of the left border of the area containing the controls.
ClientY  
Return or set the Connection that will be used by the DataSource control.
Connection  
Return the number of records.
Count  
Return the values of all primary keys of the current record as an array of Variant.
Current  
Use this property for assigning a custom cursor to a control.
Cursor  
Indicates that the control is in design mode.
Design  
Returns or sets if a control accepts drops.
Drop  
Indicates that the control is enabled.
Enabled  
Returns or sets if a control will expand if included in a container that arranges its contents.
Expand  
Returns or sets the Filter criteria property. An empty string (the default) accepts everything.
Filter  
Returns or sets the font used to draw text in the control.
Font  
Returns or sets the foreground color used by the control.
Foreground  
A synonymous for the Height property.
H  
Returns the internal X11 window handle of the control.
Handle  
Returns whether the control has the focus.
HasFocus  
Returns or sets the height of the control.
Height  
Returns whether the mouse cursor is inside the control.
Hovered  
A synonymous for the Handle property.
Id  
Returns or sets if a control must be ignored when its parent arranges its children.
Ignore  
Returns or sets if the children controls of the container are indented.
Indent  
Return the index of the current record.
Index  
Return or set if the horizontal or vertical arrangement direction is inverted.
Invert  
Returns or sets the position of the left border of the control relative to its parent.
Left  
Returns or sets if there is a margin between the container border and all its children.
Margin  
Return if the current record has been modified by one of the DataSource child.
Modified  
Returns or sets the appearence of the cursor when it points inside the control.
Mouse  
Returns or sets the name of the control.
Name  
Returns the next control having the same parent.
Next  
Return or set if a control cannot be focused with the TAB key.
NoTabFocus  
Returns or sets the number of pixels used as space between children controls, or container inner margin.
Padding  
Returns the control container.
Parent  
Return or set the name of the menu that will be popped-up when the user presses the right mouse button or the keyboard MENU key.
PopupMenu  
Returns the previous control having the same parent.
Previous  
Return or set the "proxy" of a control.
Proxy  
Return or set if the DataSource is read-only.
ReadOnly  
Returns the position of the left border of the control in screen coordinates.
ScreenX  
Returns the position of the top border of the control in screen coordinates.
ScreenY  
Return or set the field used for sorting the data.
Sort  
Returns or sets if the children of the container are spaced out.
Spacing  
Returns or sets the name of the table we want to use.
Table  
Returns or sets the control tag.
Tag  
Returns or sets the tooltip shown when the mouse stays on the control for a short time.
Tooltip  
Returns or sets the position of the top border of the control relative to its parent.
Top  
Returns or sets if the control will receive MouseMove events.
Tracking  
Indicates if the control is visible or not.
Visible  
A synonymous for the Width property.
W  
Returns or sets the width of the control.
Width  
Returns the top-level window that contains the control.
Window  
Returns or sets the position of the left border of the control relative to its parent.
X  
Returns or sets the position of the top border of the control relative to its parent.
Y  
Cancel any current edition of child controls.
Cancel  
Saves the data from the data controls and clears them afterwards. If bRefresh ist False, it does not commit the operation until you use the Refresh method.
Create  
Destroys the control.
Delete  
Starts a drag & drop process.
Drag  
Finds the first child control pointed by the X and Y coordinates.
FindChild  
GetKeys  
Grab the keyboard and the mouse so that all keyboard and mouse events are received by the control.
Grab  
Hides the control.
Hide  
Sends the control to the background of its parent.
Lower  
Moves and/or resizes the control.
Move  
Move the current record to the first record and return if the move has been possible.
MoveFirst  
Move the current record to the last record and return if the move has been possible.
MoveLast  
Move the current record to the next one and return if the move has been possible.
MoveNext  
Move the current record to the previous one and return if the move has been possible.
MovePrevious  
Moves and/or resizes the control.
MoveScaled  
Move the current record to the Indexth record and return if the move has been possible.
MoveTo  
Sends the control to the foreground of its parent.
Raise  
Trigger a redraw of the control.
Refresh  
Remove the current record from the database, and return if the remove has been possible.
Remove  
Changes the container of a control.
Reparent  
Reset the internal connection metadata cache used by the DataSource.
Reset  
Reset the internal connection metadata cache entirely.
ResetAll  
Resizes the control.
Resize  
Resizes the control.
ResizeScaled  
Writes the values of DataControls to the database (connected to through the Connection property).
Save  
Gives the focus to the control.
SetFocus  
Shows the control.
Show  
Reload the DataSource data and update all bound child controls accordingly.
Update  
This event is raised when a container has just finished arranging its contents.
Arrange  
This event is raised just before a container arranges its contents.
BeforeArrange  
This event is raised before deleting a record.
BeforeDelete  
This event is raised just before the DataSource is saved.
BeforeSave  
Raised when the DataSource current record has changed and all bound child controls are updated.
Change  
Raised when the user quickly clicks twice on the control.
DblClick  
This event is raised when the mouse enters the control during a drag & drop process.
Drag  
This event is raised when the mouse leaves the control during a drag & drop operation.
DragLeave  
This event is raised while the mouse moves inside the control during a drag & drop process.
DragMove  
This event is raised when a drag is dropped in the control.
Drop  
Raised when the mouse enters the control.
Enter  
Raised when the control has got the focus.
GotFocus  
Raised when a key is pressed while the control has the focus.
KeyPress  
Raised when a key is released while the control has the focus.
KeyRelease  
Raised when the mouse leaves the control.
Leave  
Raised when the control has lost the focus.
LostFocus  
Raised when the user clicks on the control with the right mouse button, or if it hits the MENU key.
Menu  
Raised when a mouse button is pressed while the cursor is inside the control.
MouseDown  
This event is raised when a drag operation should be started.
MouseDrag  
Raised when the mouse moves inside the control while a mouse button is pressed.
MouseMove  
Raised when a mouse button is depressed while the cursor is inside the control.
MouseUp  
This event is raised when the user moves or presses the mouse wheel while the mouse is inside the control.
MouseWheel  
This event is raised when a new child Control has just been inserted into the container.
NewChild  

See also