TRGSDBInspector
|
Properties |
|
DataSource |
Datasource to display vertically |
ColorCalcField |
Display label color when fieldtype is calculated. Used
when option useColorCalcField is turned on |
ColorLabel |
Display label color. Used when option useColorLabel is turned on |
ColorReadOnly |
Display label color when field is readonly. Used when option ColorReadOnly
is turned on |
ColorReqField |
Display label color when field is required. Used when option ColorReqField
is turned on |
ColorText |
Field text color when fieldtype is calculated. Used when option useColorCalcField
is turned on |
Fields |
A collection of predefined fields:
Properties |
|
FieldName |
Name of the field |
FieldKind |
Fieldkind |
Description |
rgsPickList |
Field must contain on of the values stored in PickItems property. |
rgsButton |
Small button is shown at field rightmost site. |
rgsCheckBox |
Checkbox is drawn into field area |
rgsCustomField |
Custom TWinControl descendent is placedinto field area |
|
ValueChecked |
If FieldKind is set to rgsCheckBox and field is not boolean field,
then this value is used for boolean TRUE |
ValueUnChecked |
If FieldKind is set to rgsCheckBox and field is not boolean field,
then this value is used for boolean FALSE |
PickItems |
If FieldKind is set to rgsPickList, these strings appear in the drop-down
list associated with the field. |
Hint |
Hint about field. |
WinControl |
Points to a TWinControl or other control derived from TWinControl when
FieldKind is set to rgsCustomField. |
|
|
Events |
|
OnButtonClick |
Fired when FieldKind is set to rgsButtonField and editbutton is pressed. |
OnGetFocus |
Fired when FieldKind is set to rgsCustomField and WinControl must get
focus |
OnLostFocus |
Fired when FieldKind is set to rgsCustomField and WinControl must give
focus away to RGSDBInspector. |
|
InspectorMode |
Mode |
Description |
imRecordView |
Inspector shows active record from Datasource.Dataset |
imVisibleFields |
Inspector lets You choose fields Visible property value. |
imPrepareFilter |
Not yet available. |
|
Options |
Option |
Description |
doLongHint |
If active, then field value is shown in hint window when field value
didn't fit into text area. |
doShowAlwaysEditor |
If true, then inplace editor is available in readonly state too. You
simply can't change fields value. |
doCheckAllFields |
If true, then You could change all fields Visible attribute by mode
imVisibleFields. Default is False (For example, it disables the ability
to set internal ID fields visible) |
useColorReqField |
Look at ColorReqField property. |
useColorCalcField |
Look at ColorCalcField property. |
useColorLabel |
Look at ColorLabel property. |
useColorText |
Look at ColorText property. |
useColorReadOnly |
Look at ColorReadOnly property. |
|
ReadOnly |
If true, no edits are availale. |
TextImage |
Text to display when fieldtype is image |
TextMemo |
Text to display when fieldtype is memo |
WinControl |
Not required. You could set it to point to a grid control |
RGSFieldNotes |
Points to TRGSFieldNotes component |
FieldNotes |
If True, then fields noted by RGSFieldNotes are painted
by assciated colors and notes are displayed in hintwindow. |
|
|
TRGSDSChooser
|
Properties |
|
DataSources |
List of datasources. List is TCollection type and each
item (datasource) has following information:
Property |
Description |
DataSource |
Name of datasource to show |
DataSourceName |
Description of datasource, shown in combobox when user selects datasource. |
ReadOnlyState |
Value |
Description |
roDefault |
DataSet.Readonly property is used |
roNever |
Underlying dataset is always editable. |
roAlways |
Underlying dataset is always readonly |
|
ShowNavigator |
Small TDBNavigator is shown under datasource selection combo. |
VisibleButtons |
List of TDBNavigator visible buttons. |
|
DSChooserOptions |
Option |
Description |
coFlat |
Flat style is used for drawing DSChooser |
|
ReadOnly |
ReadOnly state for DBInspector |
TextImage |
Text to display when fieldtype is image |
TextMemo |
Text to display when fieldtype is memo |
Events |
|
OnDataSourceChange |
Fired when active datasource changes. With this event You
could update any other data-aware components, for example DBNavigator |
OnResize |
Fired during component resize. |
|
|
TRGSBMChooser
|
Properties |
|
TextImage |
Text to display when fieldtype is image |
TextMemo |
Text to display when fieldtype is memo |
|
|
Events |
|
OnNewBookmark |
Fired before new bookmark is added to list by method AddBookmark |
OnResize |
Fired during component resize |
|
|
Methods |
|
AddBookmark |
AddBookmark(aDataset : TDataset) Adds new bookmark to bookmarks
list (internally a collection) |
|
|
TRGSFieldNotes |
|
|
|
Properties |
Fieldnotes. This is a collection with fields and notes. |
|
Property |
Description |
Dataset |
Field's dataset |
Fieldname |
Fieldname of the field |
Hint |
Message for this field. Text is shown in hintwindow when mouse moves
over the fields value. |
Color |
A TColor value which will be used for DisplayLabel in apprpriate TRgsDBInspector |
|
Methods |
Name |
Description |
Add |
Adds a new item to FieldNotes collection. Field is specified by its
dataset and fieldname properies |
AddField |
Adds a new item to FieldNotes collection. Field is specified by its
dataset and name properies |
ClearAll |
Clears the contents of FieldNotes |
ClearDataset |
Clears all items which belongs to specified dataset. |
ClearField |
Clears specified field from items |
GetField |
This function returns specified field's hint and color. Result is TRGSFieldItem
type. When field couldn't be found then it return nil. |
|
You could put one TRgsFieldNotes component per datamodule
and fill it at runtime via described methods. For example You could create
validate functions and these functions are called when user presses validate
button and in BeforePost event handler where false result raises an exception. |
|
|
|
TRGSFieldStore |
|
Component has the same properties as the Fields property
in TRgsDBInspector. It helps You collect visual information about fields
which are later displayed in different TRgsDBInspector components. |
|
|
|
|
|
TRgsStringStore |
|
This component lets You collect information presented via
strings. For example You could save the values of Your variables and later
get the values back. At this moment there is no streaming capabilities,
so You must use a thirdparty component state saving component. |
|
Function |
Description |
GetString |
Gets a previously saved value by its name, result is string type |
SetString |
Sets a string value |
GetInteger |
Gets a previously saved value by its name, result is integer type |
SetInteger |
Sets a integer value |
|
|
|
|