Object Library  CORE_FRM

This object library contains all of the basic level reusable objects of the CORE. Every CORE based listing and detail form uses some of these objects (toolbar, visual attributes). The different CORE objects are grouped on object library tabs to facilitate direct form development (done without template). See the purpose of individual tabs at their section. 

A general rule for the project that property classes don't have to be subclassed into forms, they can be directly referenced from the objects (forms, blocks) which require them. This helps keeping the size of the development units of the project lower. Other objects (e.g.: the main toolbar, visual attributes, standard parameters) have to be subclassed into the form since internal functions will look for them in the form.

Subelements:

Object Library Tabs( 3 )

Object Library Tabs

Name

Comment

BASE

Basic components which have to be inserted in every form.

LSTF

Components of listing forms.

DTLF

Components of detail forms.

Object Library Tab   BASE  

Basic components which have to be inserted in every form.

Subelements:

Tab Objects( 2 )

Tab Objects

Name

Comment

CORE_ST_HTBAR

Hosts the horizontal toolbar block (buttons, command field) appearing in every listing and detail form.

CORE_ST_HTBAR

The main toolbar which is included in every form (listing, detail).

Canvas   CORE_ST_HTBAR  

Hosts the horizontal toolbar block (buttons, command field) appearing in every listing and detail form.

Canvas properties

Value

Raise on Entry no
Popup Menu
Visible yes
Window MAIN

Canvas properties

Value

Width 359
Height 21
Bevel Raised

Subelements:

Tab pages( 0 )

Data Block   CORE_ST_HTBAR  

The main toolbar which is included in every form (listing, detail). None of its items (button) are navigable by keyboard. The command item will be fully operational only in the next release of the CORE.

The block is a memory block, its database related properties are set according to this (query, insert, update are set to No and "Single Record" is set to Yes).

Data Block properties

Value

Number of Records Displayed 1
Database Data Block no
Query Allowed no
Query Data Source Type None
Query Data Source Name
WHERE Clause

Data Block properties

Value

ORDER BY Clause
Insert Allowed yes
Update Allowed yes
Delete Allowed yes
Key Mode Automatic

Subelements:

Triggers( 0 )
Items( 4 )

Relations( 0 )

Items

Name

Comment

EXIT_BTN

Initiates the exit process of the form.

SAVE_BTN

Saves the current changes.

DETAILS_BTN

Opens the detail form of the list (if defined).

COMMAND_ITM

The command item for custom commands available on the current form.

Item   EXIT_BTN  

Initiates the exit process of the form. If there is unsaved information on the form, the system will ask for saving.

Item properties

Value

Item Type Push Button
Enabled yes
Label E
Access Key e
Implementation Class
Iconic no
Icon Filename
Default Button no
Popup Menu
Keyboard Navigable no
Mouse Navigate no
Data Type Char
Maximum Length 30
Initial Value
Required no
Copy Value from Item

Item properties

Value

Synchronize with Item
Number of Items Displayed 0
Database Item yes
Column Name
Primary Key no
Query Only no
Query Allowed yes
Insert Allowed yes
Update Allowed yes
Visible yes
Canvas CORE_ST_HTBAR
Tab Page
Visual Attribute Group DEFAULT
Prompt
Hint
Tooltip

Subelements:

Triggers( 1 )

Triggers

Name

Comment

WHEN-BUTTON-PRESSED

Trigger   WHEN-BUTTON-PRESSED  

Trigger properties

Value

Trigger Style PL/SQL
Fire in Enter-Query Mode yes
Execution Hierarchy Override

Trigger properties

Value

Display in 'Keyboard Help' no
'Keyboard Help' Text

Item   SAVE_BTN  

Saves the current changes. Then it leaves the form working for further changes done by the user.

Item properties

Value

Item Type Push Button
Enabled yes
Label S
Access Key s
Implementation Class
Iconic no
Icon Filename
Default Button no
Popup Menu
Keyboard Navigable no
Mouse Navigate no
Data Type Char
Maximum Length 30
Initial Value
Required no
Copy Value from Item

Item properties

Value

Synchronize with Item
Number of Items Displayed 0
Database Item yes
Column Name
Primary Key no
Query Only no
Query Allowed yes
Insert Allowed yes
Update Allowed yes
Visible yes
Canvas CORE_ST_HTBAR
Tab Page
Visual Attribute Group DEFAULT
Prompt
Hint
Tooltip

Subelements:

Triggers( 1 )

Triggers

Name

Comment

WHEN-BUTTON-PRESSED

Trigger   WHEN-BUTTON-PRESSED  

Trigger properties

Value

Trigger Style PL/SQL
Fire in Enter-Query Mode yes
Execution Hierarchy Override

Trigger properties

Value

Display in 'Keyboard Help' no
'Keyboard Help' Text

Item   DETAILS_BTN  

Opens the detail form of the list (if defined). When the detail form is closed, the focus returns to the field it was befor but the list doesn't get refreshed. Changes done on the detail form will be shown after the user re-queries the list.

Item properties

Value

Item Type Push Button
Enabled yes
Label D
Access Key d
Implementation Class
Iconic no
Icon Filename
Default Button no
Popup Menu
Keyboard Navigable no
Mouse Navigate no
Data Type Char
Maximum Length 30
Initial Value
Required no
Copy Value from Item

Item properties

Value

Synchronize with Item
Number of Items Displayed 0
Database Item yes
Column Name
Primary Key no
Query Only no
Query Allowed yes
Insert Allowed yes
Update Allowed yes
Visible yes
Canvas CORE_ST_HTBAR
Tab Page
Visual Attribute Group DEFAULT
Prompt
Hint
Tooltip

Subelements:

Triggers( 1 )

Triggers

Name

Comment

WHEN-BUTTON-PRESSED

Trigger   WHEN-BUTTON-PRESSED  

Trigger properties

Value

Trigger Style PL/SQL
Fire in Enter-Query Mode yes
Execution Hierarchy Override

Trigger properties

Value

Display in 'Keyboard Help' no
'Keyboard Help' Text

Item   COMMAND_ITM  

The command item for custom commands available on the current form. It doesn't work in this release of the CORE but will be fully operational in the next version.

Item properties

Value

Item Type Text Item
Enabled yes
Justification Start
Implementation Class
Multi-Line no
Wrap Style Word
Case Restriction Mixed
Conceal Data no
Keep Cursor Position no
Automatic Skip no
Popup Menu
Keyboard Navigable no
Mouse Navigate yes
Data Type Char
Maximum Length 30
Initial Value
Required no
Format Mask
Lowest Allowed Value
Highest Allowed Value
Copy Value from Item

Item properties

Value

Synchronize with Item
Number of Items Displayed 0
Database Item yes
Column Name
Primary Key no
Query Only no
Query Allowed yes
Query Length 0
Case Insensitive Query no
Insert Allowed yes
Update Allowed yes
List of Values
Validate from List no
Editor
Visible yes
Canvas CORE_ST_HTBAR
Tab Page
Visual Attribute Group DEFAULT
Prompt Cmd.
Hint
Tooltip

Subelements:

Triggers( 0 )

Object Library Tab   LSTF  

Components of listing forms. Property classes shall not be subclassed into the target form, they can be used directly from the object library. Visual attributes and parameters have to be subclassed into the target form.

Subelements:

Tab Objects( 7 )

Tab Objects

Name

Comment

CORE_LSTB

Property class for the listing block of the listing form.

CORE_LSTF

Property class for the read-only listing form.

CORE_LSTFW

Property class for the main window of the listing form.

CORE_LSTF_CFRM_ID

The ID number of the calling form.

CORE_LSTF_CMODE

The calling mode of the form (for what purpose was it called): -LST: Listing records (no specific purpose) -SEL: Selecting a record

CORE_LSTB_CREC_NORMAL

The visual attribute of the selected line in the listing block when it is in NORMAL mode.

CORE_LSTB_CREC_EQUERY

The visual attribute of the selected line in the listing block when it is in ENTER-QUERY mode.

Property Class   CORE_LSTB  

Property class for the listing block of the listing form. Disables inserting, deleting and updating in the block by setting these attributes to false design time. It supports changing the color of the currently selected row when the user enters query mode (green) and changing back to normal mode (blue). This functionality is handled in the WHEN-NEW-RECORD-INSTANCE trigger of the block(prop.class).

Property Class properties

Value

Delete Allowed no
Insert Allowed no

Property Class properties

Value

Current Record Visual Attribute Group CORE_LIST_CREC_NORMAL
Update Allowed no

Subelements:

Triggers( 2 )

Triggers

Name

Comment

WHEN-NEW-RECORD-INSTANCE

Fires when the cursor enters the record.

CORE_SHOW_DTL

Shows the detail form for the current record (if it is defined for the block/form by the developer)

Trigger   WHEN-NEW-RECORD-INSTANCE  

Fires when the cursor enters the record. Sets the color of the selected row according to the state of the block.

Trigger properties

Value

Trigger Style PL/SQL
Fire in Enter-Query Mode yes
Execution Hierarchy Override

Trigger properties

Value

Display in 'Keyboard Help' no
'Keyboard Help' Text

Trigger   CORE_SHOW_DTL  

Shows the detail form for the current record (if it is defined for the block/form by the developer)

Trigger properties

Value

Trigger Style PL/SQL
Fire in Enter-Query Mode yes
Execution Hierarchy Override

Trigger properties

Value

Display in 'Keyboard Help' no
'Keyboard Help' Text

Property Class   CORE_LSTF  

Property class for the read-only listing form.

Property Class properties

Value

Menu Module core_lstf

Subelements:

Triggers( 3 )

Triggers

Name

Comment

PRE-FORM

Runs before anything else in the form

WHEN-NEW-FORM-INSTANCE

CORE_SELECT_EXIT

Trigger   PRE-FORM  

Runs before anything else in the form

Trigger properties

Value

Trigger Style PL/SQL
Fire in Enter-Query Mode yes
Execution Hierarchy Override

Trigger properties

Value

Display in 'Keyboard Help' no
'Keyboard Help' Text

Trigger   WHEN-NEW-FORM-INSTANCE  

Trigger properties

Value

Trigger Style PL/SQL
Fire in Enter-Query Mode yes
Execution Hierarchy Override

Trigger properties

Value

Display in 'Keyboard Help' no
'Keyboard Help' Text

Trigger   CORE_SELECT_EXIT  

Trigger properties

Value

Trigger Style PL/SQL
Fire in Enter-Query Mode yes
Execution Hierarchy Override

Trigger properties

Value

Display in 'Keyboard Help' no
'Keyboard Help' Text

Property Class   CORE_LSTFW  

Property class for the main window of the listing form. Since lists cannot be resized this feature is disabled in the form.

Property Class properties

Value

Trigger Style PL/SQL
Fire in Enter-Query Mode yes
Execution Hierarchy Override

Property Class properties

Value

Display in 'Keyboard Help' no
'Keyboard Help' Text

Subelements:

Triggers( 0 )

Parameter   CORE_LSTF_CFRM_ID  

The ID number of the calling form. It is required in certain internal procedures.

Parameter properties

Value

Parameter Data Type Char
Maximum Length 100
Parameter Initial Value

Parameter   CORE_LSTF_CMODE  

The calling mode of the form (for what purpose was it called): -LST: Listing records (no specific purpose) -SEL: Selecting a record

Parameter properties

Value

Parameter Data Type Char
Maximum Length 4
Parameter Initial Value SEL

Visual Attribute   CORE_LSTB_CREC_NORMAL  

The visual attribute of the selected line in the listing block when it is in NORMAL mode.

Visual Attribute properties

Value

Foreground Color
Background Color r25g75b100
Fill Pattern
Font Name

Visual Attribute properties

Value

Font Size 0
Font Weight Medium
Font Style Plain
Font Spacing Normal

Visual Attribute   CORE_LSTB_CREC_EQUERY  

The visual attribute of the selected line in the listing block when it is in ENTER-QUERY mode.

Visual Attribute properties

Value

Foreground Color
Background Color r0g75b50
Fill Pattern
Font Name

Visual Attribute properties

Value

Font Size 0
Font Weight Medium
Font Style Plain
Font Spacing Normal

Object Library Tab   DTLF  

Components of detail forms. Property classes shall not be subclassed into the target form, they can be used directly from the object library. Visual attributes and parameters have to be subclassed into the target form.

Subelements:

Tab Objects( 9 )

Tab Objects

Name

Comment

CORE_DTLF_CFRM_ID

The ID number of the calling form.

CORE_DTLF_CMODE

The calling mode of the detail form (for what purpose was it called): -DTL: Show details (possibly editing by the user).

CORE_DTLF_OBJ_ID

Contains the ID of the object what the detail form has to show to the user.

CORE_DTLFW

Property class for the main window of the detail form.

CORE_DTLF

Property class for the detail form which can show/edit/record data.

CORE_RLB

Property class for the referencing listing block on the detail form.

CORE_DTLMB

Property class for the main block of the detail form.

CORE_RLB_CREC_NORMAL

The visual attribute of the selected line in the listing block when it is in NORMAL mode.

CORE_RLB_CREC_EQUERY

The visual attribute of the selected line in the listing block when it is in ENTER-QUERY mode.

Parameter   CORE_DTLF_CFRM_ID  

The ID number of the calling form. It is required in certain internal procedures.

Parameter properties

Value

Parameter Data Type Char
Maximum Length 100
Parameter Initial Value

Parameter   CORE_DTLF_CMODE  

The calling mode of the detail form (for what purpose was it called): -DTL: Show details (possibly editing by the user). The user can enter new record as well after viewing the record. -NEW: Entering new record.

Parameter properties

Value

Parameter Data Type Char
Maximum Length 4
Parameter Initial Value NEW

Parameter   CORE_DTLF_OBJ_ID  

Contains the ID of the object what the detail form has to show to the user. When the form starts it will query the main block using this ID in order to show the data to the user.

Parameter properties

Value

Parameter Data Type Char
Maximum Length 50
Parameter Initial Value

Property Class   CORE_DTLFW  

Property class for the main window of the detail form. It is modal (doesn't allow the user to go back to the calling form until the operation is finished on the detail foirm.) Since usually there is no layout management on Forms resizing of the windows is also disabled.

Property Class properties

Value

Parameter Data Type Char
Maximum Length 30
Parameter Initial Value

Subelements:

Triggers( 0 )

Property Class   CORE_DTLF  

Property class for the detail form which can show/edit/record data. When in new mode, it makes the user able to create a new record. When in view/edit mode, it accepts an ID in one of its CORE parameters. The form automatically queries the requested record and provides it for the user to view or data edit. In edit mode, the user can save the changes he or she made and close the form.

Property Class properties

Value

Menu Module core_dtlf

Subelements:

Triggers( 5 )

Triggers

Name

Comment

PRE-FORM

This trigger can be customized according to the task the form attends.

WHEN-NEW-FORM-INSTANCE

KEY-COMMIT

KEY-EXIT

CORE_SAVE_EXIT

Trigger   PRE-FORM  

This trigger can be customized according to the task the form attends. Customizations may take place AFTER the core function call in order to let the core form management system do its initialisation.

Trigger properties

Value

Trigger Style PL/SQL
Fire in Enter-Query Mode yes
Execution Hierarchy Override

Trigger properties

Value

Display in 'Keyboard Help' no
'Keyboard Help' Text

Trigger   WHEN-NEW-FORM-INSTANCE  

Trigger properties

Value

Trigger Style PL/SQL
Fire in Enter-Query Mode yes
Execution Hierarchy Override

Trigger properties

Value

Display in 'Keyboard Help' no
'Keyboard Help' Text

Trigger   KEY-COMMIT  

Trigger properties

Value

Trigger Style PL/SQL
Fire in Enter-Query Mode yes
Execution Hierarchy Override

Trigger properties

Value

Display in 'Keyboard Help' no
'Keyboard Help' Text

Trigger   KEY-EXIT  

Trigger properties

Value

Trigger Style PL/SQL
Fire in Enter-Query Mode yes
Execution Hierarchy Override

Trigger properties

Value

Display in 'Keyboard Help' no
'Keyboard Help' Text

Trigger   CORE_SAVE_EXIT  

Trigger properties

Value

Trigger Style PL/SQL
Fire in Enter-Query Mode yes
Execution Hierarchy Override

Trigger properties

Value

Display in 'Keyboard Help' no
'Keyboard Help' Text

Property Class   CORE_RLB  

Property class for the referencing listing block on the detail form. Usually, connected to the main block with a relation. It supports changing the color of the currently selected row like on the listing form. Doesn't support detail showing.

Property Class properties

Value

Current Record Visual Attribute Group CORE_RLB_CREC_NORMAL

Subelements:

Triggers( 3 )

Triggers

Name

Comment

WHEN-NEW-RECORD-INSTANCE

WHEN-NEW-BLOCK-INSTANCE

POST-BLOCK

Trigger   WHEN-NEW-RECORD-INSTANCE  

Trigger properties

Value

Trigger Style PL/SQL
Fire in Enter-Query Mode yes
Execution Hierarchy Override

Trigger properties

Value

Display in 'Keyboard Help' no
'Keyboard Help' Text

Trigger   WHEN-NEW-BLOCK-INSTANCE  

Trigger properties

Value

Trigger Style PL/SQL
Fire in Enter-Query Mode yes
Execution Hierarchy Override

Trigger properties

Value

Display in 'Keyboard Help' no
'Keyboard Help' Text

Trigger   POST-BLOCK  

Trigger properties

Value

Trigger Style PL/SQL
Fire in Enter-Query Mode yes
Execution Hierarchy Override

Trigger properties

Value

Display in 'Keyboard Help' no
'Keyboard Help' Text

Property Class   CORE_DTLMB  

Property class for the main block of the detail form. It disables the query allowed parameter of the block by default since querying of the main block is done automatically by the core.

Property Class properties

Value

Query Allowed no
Navigation Style Change Data Block

Subelements:

Triggers( 0 )

Visual Attribute   CORE_RLB_CREC_NORMAL  

The visual attribute of the selected line in the listing block when it is in NORMAL mode.

Visual Attribute properties

Value

Foreground Color
Background Color r25g75b100
Fill Pattern
Font Name

Visual Attribute properties

Value

Font Size 0
Font Weight Medium
Font Style Plain
Font Spacing Normal

Visual Attribute   CORE_RLB_CREC_EQUERY  

The visual attribute of the selected line in the listing block when it is in ENTER-QUERY mode.

Visual Attribute properties

Value

Foreground Color
Background Color r0g75b50
Fill Pattern
Font Name

Visual Attribute properties

Value

Font Size 0
Font Weight Medium
Font Style Plain
Font Spacing Normal