How Do I...

Example: Add a form and actions

Add a form No tip for this topic No example for this topic Use a form

This example shows how to make a form that has text fields which display input from a user.

Making the form's user interface

Begin by creating an application, adding a visual part to it, and opening a Composition Editor on the visual part. Then, in the Composition Editor, create the form:

  1. Delete the window.
  2. Select Canvas category icon (Canvas category) and then Form icon ( part).
  3. Click on the free-form surface.

Next, add one Text icon (Text part) and one Multi-line Edit icon (Multi-line Edit part). Both of these are in Data Entry category icon (Data Entry category). Arrange the parts so the form looks like the following:
Parts on form

Adding actions

So other parts can display data in the text fields, add scripts that provide a public interface for the text fields:

  1. Select Public Interface Editor in the lower-right corner of the Composition Editor to open a Public Interface Editor for the visual part.
  2. Select the Action tab.
  3. Type the following into the Action name field:
    setName:
    

    Then, select Add with defaults.

  4. Repeat step 3, except add
    setAddress:
    
  5. From the File menu, select Generate Default Scripts.
  6. In the window that opens, highlight setName: and setAddress: in the Selectors field. Then, select Generate selected. VisualAge generates code for the two scripts.

Defining code for the actions

Now, select Script Editor to go to the Script Editor. In the Script Editor, change the scripts generated so they set values for the text fields:

  1. Toggle the Instance/Class button so the category Not Categorized appears in the upper left pane.
  2. Select Not categorized and then setName: in the upper-right pane.
  3. Add a blank line after the code displayed in the lower pane for setName:.
  4. Click on the Subpart Features Syntax icon icon in the upper-left of the editor.
  5. In the displayed window, select the Text part in the Subparts field and object in the Attributes field. Next, press mouse button 2 on the Attributes field and select Paste 'set' from the pop-up menu.
  6. Replace <your expression here> with parm1. parm1 represents the value that the user gives. After you change the code, it resembles the following:
    setName: parm1
      "Perform the setName: action."
      (self subpartNamed: 'Text1') object: parm1
    
  7. Save the script.

Repeat the previous steps for setAddress, only paste the setter for the object attribute of the Multi-line Edit subpart. After you change the code, it resembles:

setAddress: parm1
  "Perform the setAddress: action."
  (self subpartNamed: 'Multi-line Edit1') object: parm1

Finally, save the part. You can now use the form in other applications.


[ Top of Page | Previous Page | Next Page | Table of Contents ]