Event Sequences

From Lianjapedia
Revision as of 20:47, 10 December 2017 by Barrymavin (Talk | contribs)

Jump to: navigation, search

This article requires updating for 4.1 as many more delegates are handled in Web/Mobile


See Also

Custom Delegates

Opening and Closing

Opening an App

Desktop

When a Desktop App is opened, the following event delegates are called:

  • init
  • visiblewhen, enabledwhen (runtime only)
  • load
  • datachanged, parentdatachanged, refresh
  • ready
  • resized (Canvas and Custom Sections)
  • activate

Setup.prg

If setup.prg exists in the App's directory, setup.prg is run.

INIT

  • App
    • Page1
      • Section1 (If Section1 has a 'database' value, the database is opened, running dbc_opendata.prg if it exists in the database's directory. If a database is open and Section1 has a 'table' value, the table is opened, running the table onopen trigger if one exists.)
        • Field1
        • Field2
        • FieldN
      • Section2 (Database and/or Section2's table as for Section1 above)
        • Field1 ... FieldN
      • SectionN (Database and/or SectionN's table as for Section1 above)
        • Field1 ... FieldN
    • Page2
      • Section1 (Database and/or Section1's table as for Page 1, Section1 above)
        • Field1 ... FieldN
      • Section2 (Database and/or Section2's table as for Page 1, Section1 above)
        • Field1 ... FieldN
      • SectionN (Database and/or SectionN's table as for Page 1, Section1 above)
        • Field1 ... FieldN
    • PageN
      • Section1 (Database and/or Section1's table as for Page 1, Section1 above)
        • Field1 ... FieldN
      • Section2 (Database and/or Section2's table as for Page 1, Section1 above)
        • Field1 ... FieldN
      • SectionN (Database and/or SectionN's table as for Page 1, Section1 above)
        • Field1 ... FieldN

VISIBLE WHEN

The VISIBLE WHEN event is called for Pages and their Sections (runtime only). Called after the object's init; other objects' init may not yet have been called.

ENABLED WHEN

The ENABLED WHEN event is called for Pages and their Sections (runtime only). Called after the object's init and visiblewhen; other objects' init and visiblewhen may not yet have been called.

LOAD

  • App
    • Page1
      • Section1
        • Field1 ... FieldN
      • ...
      • SectionN
        • Field1 ... FieldN
    • ...
    • PageN
      • Section1
        • Field1 ... FieldN
      • ...
      • SectionN
        • Field1 ... FieldN

DATACHANGED

The DATACHANGED event is called for Form Sections and their Fields.

PARENTDATACHANGED

The PARENTDATACHANGED event is called for related child Sections.

REFRESH

The REFRESH event is called for Sections.

READY

  • App
    • Page1
      • Section1
        • Field1 ... FieldN
      • ...
      • SectionN
        • Field1 ... FieldN
    • ...
    • PageN
      • Section1
        • Field1 ... FieldN
      • ...
      • SectionN
        • Field1 ... FieldN

RESIZED

The RESIZED event is called for all Canvas and Custom Sections.

ACTIVATE

  • Page1 (or Page specified in the App 'Initial Page' attribute or first Page user has permission to read)
    • Section1
      • Field1 ... FieldN
    • ...
    • SectionN
      • Field1 ... FieldN

Web/Mobile App

When a Web/Mobile App is opened, the following event delegates are called:

INIT

  • App
    • Page1
      • FormSection1 Field1 ... FieldN
      • ...
    • Page2
      • FormSection1 Field1 ... FieldN
      • ...
    • ...
      • ...
    • PageN
      • FormSection1 Field1 ... FieldN
      • ...

LOAD

  • App
    • Page1
      • FormSection1 Field1 ... FieldN
      • ...
    • Page2
      • FormSection1 Field1 ... FieldN
      • ...
    • ...
      • ...
    • PageN
      • FormSection1 Field1 ... FieldN
      • ...

READY

  • App
    • Page1
      • FormSection1 Field1 ... FieldN
      • ...
    • Page2
      • FormSection1 Field1 ... FieldN
      • ...
    • ...
      • ...
    • PageN
      • FormSection1 Field1 ... FieldN
      • ...

RESIZED

The RESIZED event is called for all Canvas and Custom Sections.

ACTIVATE

  • Page1 (or Page specified in the App 'Initial Page' attribute or first Page user has permission to read)


Closing an App

Desktop

When a Desktop App is closed, the following event delegates are called:

UNLOAD and DESTROY

  • Page1 UNLOAD
    • Section1 UNLOAD
    • ...
    • SectionN UNLOAD
  • Page1 DESTROY
    • Section1 DESTROY
    • ...
    • SectionN DESTROY
  • Page2 UNLOAD
    • Section1 UNLOAD
    • ...
    • SectionN UNLOAD
  • Page2 DESTROY
    • Section1 DESTROY
    • ...
    • SectionN DESTROY
  • ...
  • PageN UNLOAD
    • Section1 UNLOAD
    • ...
    • SectionN UNLOAD
  • PageN DESTROY
    • Section1 DESTROY
    • ...
    • SectionN DESTROY
  • App UNLOAD
  • App DESTROY

The database is closed, running dbc_closedata.prg if it exists in the database's directory. Tables are closed, running the tables' onclose trigger if applicable.

Web/Mobile App

  • None

Navigating

Navigating between Pages

When changing from one page (Page1) to another (Page2), the following event delegates are called:

Desktop

DEACTIVATE

  • Page1
    • Section1
      • Field1 ... FieldN
    • ...
    • SectionN
      • Field1 ... FieldN

ACTIVATE

  • Page2
    • Section1
      • Field1 ... FieldN
    • ...
    • SectionN
      • Field1 ... FieldN

VISIBLE WHEN and ENABLED WHEN

  • Page2 VISIBLE WHEN (runtime only)
  • Page2 ENABLED WHEN (runtime only)
    • Section1 VISIBLE WHEN (runtime only)
    • Section1 ENABLED WHEN (runtime only)
    • ...
    • SectionN VISIBLE WHEN (runtime desktop only)
    • SectionN ENABLED WHEN (runtime desktop only)

Web/Mobile App

DEACTIVATE

  • Page1

ACTIVATE

  • Page2

Navigating Form Section

Desktop

Using Page actionbar or Section header actionbar

  • FormSection DATACHANGED
  • FormSection REFRESH
    • Field1 ... FieldN DATACHANGED
  • RelatedSection PARENTDATACHANGED
  • RelatedSection DATACHANGED (if Form Section)
  • RelatedSection REFRESH (if Form Section)
    • Field1 ... FieldN DATACHANGED (if Form Section)

Web/Mobile App

Using Page actionbar

  • None

Navigating Grid Section

Desktop

From row to row (cursor or mouse) or using Page navigation buttons in the Grid Section actionbar

  • GridSection CLICK
  • RelatedSection PARENTDATACHANGED
  • RelatedSection DATACHANGED (if Form Section)
  • RelatedSection REFRESH (if Form Section)
    • Field1 ... FieldN DATACHANGED (if Form Section)

Web/Mobile App

From row to row (mouse) or using Page navigation buttons in the Grid Section actionbar

  • None

Data Operations

Adding a new record

Desktop

When the 'Add New Record' button in the Page actionbar or the 'Add' button in the Section actionbar is clicked, the following events are called:

BEFORECREATE

  • Section

ONBEFOREINSERT

If it exists, the bound table's ONBEFOREINSERT trigger is called.

ONAFTERINSERT

If it exists, the bound table's ONAFTERINSERT trigger is called.

AFTERCREATE

  • Section

REFRESH, DATACHANGED and PARENTDATACHANGED

  • Section REFRESH
    • Field1 ... FieldN DATACHANGED
  • RelatedSection PARENTDATACHANGED
  • RelatedSection DATACHANGED (if Form Section)
  • RelatedSection REFRESH (if Form Section)
    • Field1 ... FieldN DATACHANGED (if Form Section)


Updating and saving the newly added record calls the events as in Updating a record below.


If the 'Undo Change' button in the Page actionbar or the 'Revert' button in the Section actionbar is clicked, the events called are as in Deleting a record below.

Web/Mobile App

Updating and saving the newly added record calls the events as in Updating a record below.

Updating a record

Desktop

Form Section

INTERACTIVECHANGE

The INTERACTIVECHANGE event is called on each entered keypress for editable fields.

HOTKEY

The HOTKEY event is called on non-entered keypresses for editable fields, e.g. Tab, Backspace.

VALIDATION

If specified, the VALIDATION Attribute expression is checked on exiting a modified field.

VALIDWHEN

Called after the save of a full Section edit, not an inline field edit.

  • Page
  • Section

BEFOREUPDATE

This and subsequent events are called after the save of a full Section or inline field edit.

  • Section

ONBEFOREUPDATE

If it exists, the bound table's ONBEFOREUPDATE trigger is called.

ONAFTERUPDATE

If it exists, the bound table's ONAFTERUPDATE trigger is called.

AFTERUPDATE

  • Section

REFRESH, DATACHANGED and PARENTDATACHANGED

  • Section REFRESH
  • Section DATACHANGED
    • Field1 ... FieldN DATACHANGED
  • RelatedSection PARENTDATACHANGED
  • RelatedSection DATACHANGED (if Form Section)
  • RelatedSection REFRESH (if Form Section)
    • Field1 ... FieldN DATACHANGED (if Form Section)

Canvas Section

MOUSEENTER

The MOUSEENTER event is called on editable fields.

GOTFOCUS

The GOTFOCUS event is called on editable fields.

CLICK

The CLICK event is called on editable fields.

INTERACTIVECHANGE

The INTERACTIVECHANGE event is called on each entered keypress for editable fields.

HOTKEY

The HOTKEY event is called on non-entered keypresses for editable fields, e.g. Tab, Backspace.

MOUSELEAVE

The MOUSELEAVE event is called on editable fields.

VALIDATION

If specified, the VALIDATION Attribute expression is checked for each modified field on exiting the field.

LOSTFOCUS

The LOSTFOCUS event is called on editable fields.

VALIDWHEN

  • Page
  • Section

BEFOREUPDATE

  • Section

ONBEFOREUPDATE

If it exists, the bound table's ONBEFOREUPDATE trigger is called.

ONAFTERUPDATE

If it exists, the bound table's ONAFTERUPDATE trigger is called.

AFTERUPDATE

  • Section

REFRESH, DATACHANGED and PARENTDATACHANGED

  • Section REFRESH
    • Field1 ... FieldN DATACHANGED
  • RelatedSection PARENTDATACHANGED
  • RelatedSection DATACHANGED (if Form Section)
  • RelatedSection REFRESH (if Form Section)
    • Field1 ... FieldN DATACHANGED (if Form Section)

Grid Section

VALIDATION

If specified, the VALIDATION Attribute expression is checked on exiting a modified cell.

The following events are called after clicking the Grid Section actionbar 'Save' button or moving to another grid row after modifying a Grid Section column.

VALIDWHEN

  • Section

BEFOREUPDATE

  • Section

ONBEFOREUPDATE

If it exists, the bound table's ONBEFOREUPDATE trigger is called.

ONAFTERUPDATE

If it exists, the bound table's ONAFTERUPDATE trigger is called.

AFTERUPDATE

  • Section

Changed

    • Section
  • Page

Web/Mobile App

Form Section

GOTFOCUS

The GOTFOCUS event is called on editable fields.

INTERACTIVECHANGE

The INTERACTIVECHANGE event is called on each entered keypress for editable fields.

CHANGED

The CHANGED event is called on modified fields.

LOSTFOCUS

The LOSTFOCUS event is called on editable fields.

Canvas Section

MOUSEENTER

The MOUSEENTER event is called on editable fields.

GOTFOCUS

The GOTFOCUS event is called on editable fields.

CLICK

The CLICK event is called on editable fields.

INTERACTIVECHANGE

The INTERACTIVECHANGE event is called on each entered keypress for editable fields.

CHANGED

The CHANGED event is called on modified fields.

LOSTFOCUS

The LOSTFOCUS event is called on editable fields.

MOUSELEAVE

The MOUSELEAVE event is called on editable fields.

Grid Section

The following events are called after editing and saving a Grid Section row in the 'Edit Record' dialog.

  • None

Deleting a record

Desktop

When the 'Delete Record' button in the Page actionbar or the 'Delete' button in the Section actionbar is clicked, the following events are called:

BEFOREDELETE

  • Section

ONBEFOREDELETE

If it exists, the bound table's ONBEFOREDELETE trigger is called.

ONAFTERDELETE

If it exists, the bound table's ONAFTERDELETE trigger is called.

AFTERDELETE

  • Section

REFRESH, DATACHANGED and PARENTDATACHANGED

  • Section DATACHANGED
  • Section REFRESH
    • Field1 ... FieldN DATACHANGED
  • RelatedSection PARENTDATACHANGED
  • RelatedSection DATACHANGED (if Form Section)
  • RelatedSection REFRESH (if Form Section)
    • Field1 ... FieldN DATACHANGED (if Form Section)

Web/Mobile App

  • None
Retrieved from "https://www.lianja.com/doc/index.php?title=Event_Delegate_Sequences&oldid=19168"