Using the Applet Method Menu Item Wizard in Web Tools

The Applet Method Menu Item Wizard in Web Tools lets you update an applet’s menu by adding, removing, or associating command/menu items. You can either create a new menu item by linking an existing Command object to the applet menu, or manage existing Applet/Class Method Menu Item records to control which commands appear in the applet’s menu.

This wizard allows you to modify Applet Menus by adding or removing items in the Menu’s list of commands. There are two paths in the wizard.

  1. Create New Menu Item
  2. Use existing Menu Item

Associating an Existing Command Object to an Applet Menu

This choice takes a Command object that has never been associated to an Applet's Menu and creates the Applet Method Menu Item record under a particular Applet. The "new" part of this is that this Command's association to the Applet's Menu has not previously been created as there are no Applet Method Menu Item records for that Applet using this Command.

To associate a Command to an Applet's Menu:

  1. In an editable Developer Workspace start the wizard by choosing the Applet Method Menu icon and clicking Start.
  2. Enter the name of the Applet you wish to modify.
  3. Click Next.
  4. Choose Create New Menu Item.
  5. Click Next.
  6. Choose an existing Command Object from the Pick Applet.
  7. Give the Name that you would like to appear in the Applet Menu.
  8. Click Next.
  9. Review the brief summary to make sure all is as desired.
  10. Click Submit when you are satisfied with your choices.
  11. Navigate to the Applet and review the new Applet Method Menu Item records under Applet > Applet Method Menu Item.

Using Existing Applet Method Menu Item Records to Modify an Applet's Menu

This option will use existing records from two areas. You can add or remove Applet Menu Items from both during the wizard's execution. These records are those that already exist for the current Applet in the Applet Method Menu Item list in the Repository. When you remove an item (move a record from the Selected to the Available list) that record will be deleted from the current Workspace.

  1. Applet Method Menu Item records for a particular Applet
  2. Class Method Menu Item records for the C++ Class that backs the Applet.

To add or remove Applet Method Menu Items from an Applet's Menu:

  1. In an editable Developer Workspace start the wizard by choosing the Applet Method Menu icon and clicking Start.
  2. Enter the name of the Applet you wish to modify.
  3. Click Next.
  4. In the Applet Method Menu Item: Choose Commands Applet, you can add or remove Commands from the Applets currently defined Applet Method Menu Item records. To move items to the Selected Applet, choose them in the Available Applet and click the >> icon to move them from Available to Selected.
    Note: Even though a Command may already be present in the Selected Applet, it may still show in the Available Applet. The two panes may have identical records. This is expected. The Available list shows all the defined records under this Applet's Applet Method Menu Item list. That does not mean that all the records are implemented and will be shown in the Menu. Only when you have moved them to the Selected list and finished the Applet will they be shown in the Applet's Menu. Those Commands in the Selected Applet are the ones that will be implemented in the Applet.
  5. Click Next.

  6. Choose the Commands from the C++ inheritance hierarchy that you wish to implement in the current Applet while in the Applet Method Menu Item: Choose Class Commands View. Command objects can define Class Method Menu Items. These are child records of the Class Object Type in the Repository. For the Applet's current C++ Class and any super classes that define Class Method Menu Items, you will see these records here. Defining a Class Method Menu Item allows you to use that functionality in any Applet that uses that Class or one of its super classes.

  7. Click Next.

  8. The Summary screen will display what you have added and removed from the Applet. If satisfied, click Submit.

  9. Navigate to the Applet and review the new Applet Method Menu Item under Applet > Applet Method Menu Item.