Webster+

Special Webster+ Events

The special internal events supported by Webster+ are listed below.

Event

Description

*addto:xxx

The *addto event can be applied to an [input] short code to indicate that, when the input is changed by the user, the value of the input will be added as a new item to the drag and drop list identified by xxx. See Drag and Drop Lists.

(The *add event was added in PxPlus 2022.)

*close

Closes the current page and either closes the tab/popup window if it was opened by Webster+ or else returns to the *default page.

*drill:page,set$,point$

The *drill event can be applied to a [chart] short code for the purposes of providing a drill down on the set/point selected/clicked by the user.

The three comma-separated parameters are:

page

This field should contain the name of the page that will be invoked.

set$

This is the name of a variable that will be initialized with the name/number of the set selected.

point$

This optional parameter contains the name of the variable to receive the name/number of the point selected.

Example:

   *drill:customer,client$,month$

   This would invoke the page "customer", passing it the set name in the variable Client$ and the point name in the variable Month$.

(The *drill event was added in PxPlus 2023.)

*eval:javascript

Locally executes the JavaScript specified on the browser. No event will be sent to the server.

*link:xxx

Links to a new page or URL.

*map,xxx,xxx,xxx,xxx

Can be added to a button to cause the system to display a popup window presenting a Google Map based on the address provided in the parameters xxx. You can provide up to five values to specify the street address, city, province/state and country. These can either be variables from the page or literals.

Example:

   event=*map,"25 Centurian Blvd","Markham","Ontario"

   event=*map,street$,city$,state$,country$

(The *map event was added in PxPlus 2022.)

*pop

Closes a popup window.

*redraw

Forces a redraw of the screen using the current field contents.

*reload

Forces a reload of the page after discarding the current data.

*return:xxx

Can be used in a popup window to return the value of the field named by xxx. This value will be returned to the input field on the parent page that initiated the popup window and its change event (if any) will be triggered. This is generally used by the Query system.

Optionally, you can specify two additional comma-separated values following the field name. They are:

     The field on the parent page to receive the value.

   •  The event to trigger in the parent page after the current page is closed.

The following internal events are for grid use only:

Event

Description

*RowDel

Clicking on this column will cause the grid row to be deleted. There is a two-second delay before the row is deleted during which time the user may click on the row to cancel the deletion. Once the deletion is complete, the row may not be restored.

*RowDrag

Clicking down on the column allows the row to be dragged to a new position and released. If the row is dragged above or below the grid, the grid will be scrolled.

If the row is released above the grid, the row will become the first row in the grid. If released below the grid, it will become the last row in the grid.

You can also send an event to a program other than the one specified on the [form] short code. Simply prefix the event with the name of the program you want to run, followed by an @ (at sign).

Example:

In this example, the following event declaration would cause the event "Changed" in the program "MyProg" to be invoked:

Event=MyProg@Changed