Attaching Scripts to Events

Description

With the exception of Global Scripts, which can be run directly by the user, Xbasic scripts cannot be run directly. Rather, they are run automatically in response to various events (such as Pressing a button, saving a record, deleting a record etc. ) that occur when you are using Alpha Anywhere. Xbasic scripts are "attached" to events, and are run when the event occurs. For example, a script might be attached to the OnActivate event for a control on a form. When that control gets focus, the script is automatically run. To attach a script to an object event:

Edit the form that contains the object.
Right click on the object.
Select Events > Event_Name from the right click menu. The Code Editor is displayed.
Type the script in the Code Editor.
Select File > Save to save the script.

To attach a script to a field or record event:

Edit Field Rules for the table.
Click on the Events tab. An embedded code editor is displayed. You can define events in this editor, or you can click the Open Code Editor button to launch the Code Editor.

Event Name
Occurs
CanEditField

Before the cursor enters the field.

OnEditField

After the cursor enters the field.

CanWriteField

Before the cursor exits the field.

OnWroteField

After the cursor exits the field.

The following record events can trigger scripts.

Event Name
Occurs
CanChangeRecord

Before entering Change mode.

OnChangeRecord

After entering Change mode.

CanDeleteRecord

After deleting a record.

OnDeleteRecord

After deleting a record.

CanEnterRecord

Before moving to the new record.

OnEnterRecord

After moving to the new record

CanMarkRecord

Before marking a record.

OnMarkRecord

After marking a record.

CanSaveRecord

Before saving a record.

OnSaveRecord

After saving a record.

CanUnmarkRecord

Before unmarking a record.

OnUnmarkRecord

After unmarking a record.

See Also