Tying Page Elements to Data : Buttons and Links

Buttons and Links
In ActiveGrid Applications, all submits on the Page are associated with one or more defined Actions. When a user clicks on a button, link or other submit, the client sends a request to the ActiveGrid Server. The request contains the identity of the Action along with any data that the user submitted.
In order to add a button or link to a Page, you must first define the associated Action. After you define the Action you want to invoke, you can insert the button or link that invokes it. A button or link can have more than one Action. The server executes the Actions sequentially, in the order you list them.
Message Ref Property for Buttons and Links
The Message Ref property on button and links identifies the “selected” object. When the user clicks the button or link, the object identified by the Message Ref property becomes the “selected” object in the request (Identifying a Single Object in a List of Objects).
Action: Target and Ref Properties
In the Page Editor, you can set two important properties for each Action: the Target property and the Ref property:
The Target property specifies where to display the results of the Action. Typically, you specify an AJAXFrame (AJAXFrames) on the page or the Main AJAX Frame in the Page Frame (The Page Frame). You can also choose to display the results in a popup menu.
The Ref property specifies which user-changed fields are actually sent back to the server when the form is submitted. If the Ref property is blank (no Ref) then the application sends back all the changed fields. Alternatively, you can use the Ref property to restrict what objects get sent back. If you do not want to send anything back, type in the following value for the Ref property:
null()
For example, a navigational link to another Page would have a Ref property value of null().
Related Topics:
Page Message
Message Refs
AJAXFrames
Defining Actions in Page Flows

ActiveGrid
ActiveGrid Documentation
Version 2.0