How To Modify a Shortcut Menu at Run Time

• Microsoft Visual FoxPro for Windows, version 5.0

SUMMARY

The Visual FoxPro menu generator, Genmenu.prg, now contains a new generator directive to accommodate support for the new shortcut menus. The generator directive is called #PREPOP. Normally, GENMENU adds the contents of the Cleanup snippet at the end of the menu definition. With shortcut menus, the ACTIVATE POPUP command is inserted prior to the contents of the Cleanup snippet. Therefore, none of the Cleanup code executes until after the menu is deactivated. The #PREPOP generator directive places the Cleanup code (not including Procedures or functions) prior to the ACTIVATE POPUP command. This new functionality allows you to disable, enable, mark, or unmark menu items at run time.

MORE INFORMATION

This example demonstrates the use of the #PREPOP generator directive. In the example, a command button toggles the form's AlwaysOnTop property between true (.T.) and false (.F.). Based on the value of this property, a check mark appears next to a menu bar within the shortcut menu. The following steps create the example:

1. Create a shortcut menu named NewShort.

2. Use the layout below to add three menu prompts to the shortcut menu:

          Prompt            Result
          --------------------------
   
          \<Date           Command
          \<Test           Command
          \<AlwaysOnTop    Procedure
   
   

3. In the procedure of AlwaysOnTop prompt, type the following code:

   IF TYPE("oRef") = "O"

             oRef.command1.Click
          ENDIF
   
   

4. Click the View menu and click General Option to access the Setup and CleanUp snippets. In the Setup snippet, type the following code:

   PARAMETER oRef #PREPOP

   Close the Setup snippet box.

5. Open the CleanUp snippet and type the following code:

   SET MARK OF BAR 3 OF SHORTCUT TO oRef.AlwaysOnTop

   Close the CleanUp snippet box.

6. Generate the menu.

7. Create a form named ShortCut.

8. In the RightClick method of the form, add the following code:

   DO NewShort.mpr WITH THIS

9. Place a command button on the form and change the following properties:

   Caption = NotAlwaysOnTop Name = Command1

10. In the Click method of the command button, type the following code:

    IF THIS.Caption = "NotAlwaysOnTop"

             THISFORM.AlwaysOnTop = .T.
             THIS.Caption = "AlwaysOnTop"
          ELSE
             THIS.Caption = "NotAlwaysOnTop"
             THISFORM.AlwaysOnTop = .F.
          ENDIF