DOCUMENT:Q182580 29-JUL-1999 [foxpro]
TITLE :HOWTO: Set Up a Quick Menu for an ActiveDoc App
PRODUCT :Microsoft FoxPro
PROD/VER:WINDOWS:6.0
OPER/SYS:
KEYWORDS:
======================================================================
-------------------------------------------------------------------------------
The information in this article applies to:
- Microsoft Visual FoxPro for Windows, version 6.0
-------------------------------------------------------------------------------
SUMMARY
=======
This article describes setting up a Quick Menu for use in an Active Document
application, which is a new feature in Visual FoxPro 6.0.
MORE INFORMATION
================
Chapter 31 of the Microsoft Visual FoxPro "Programmer's Guide," version 6.0 is a
good source for information on creating Active Document applications. The
chapter contains an explanation of Menu Negotiation, terms used in Menu
Negotiation, Help Menu Merging and enhancements to the DEFINE PAD command.
The steps below guide the developer in creating a Quick Menu that can be used in
an Active Document application. This menu will have a custom menu pad and
Colors, in addition to the menu pads provided by FoxPro with a Quick Menu. It
also illustrates Help Menu Merging with the Fruits menu pad.
Steps to Create a Quick Menu
----------------------------
1. Create a new menu, not a shortcut. The code below can be typed in the Command
window to accomplish this task. In the New Menu dialog box select menu. Here
is the code:
CREATE MENU ADTest
2. From the System menu, point to the Menu pad, and then click Quick Menu.
3. Delete the View and Tools menu pads. This is not necessary, it just prevents
the menu from getting too long in this example. The Program menu will be left
in case Cancel, Resume or Suspend are needed.
4. Insert a new Menu pad between Edit and Program.
NOTE: Select the Program prompt and point to the Insert button in the Menu
Designer.
5. Name the new prompt \<Colors. The \< causes the C in Colors to be
underlined. The result should be a submenu, which should be created now.
6. Create three submenu prompts for Colors and enter Red, Blue, and Green. The
Result of each should be a Command. For the command, type in the following:
WAIT WINDOW "Red"
WAIT WINDOW "Blue"
7. Go back to the main Menu bar. Add a new prompt on the end after the Help
prompt. Name it Fr\<uits. The Result should be a submenu. Create the
submenu just like the submenu for Colors. However, this time, use "Apples,"
"Bananas," and "Grapes" for the prompts. Make the Results WAIT WINDOW
commands with the fruit names just as Color example in step six. Go back to
the main Menu bar when finished.
8. Now the menu negotiation needs to be created. For the File prompt, select the
Options button. In the top-right corner of the Prompt Options dialog box is a
Negotiate section. For the purposes of this dialog box, remember the
following:
Container = When the menu is run in Visual FoxPro.
Object = When the menu is run hosted in an Active Document Container, such as
Internet Explorer.
The File prompt should be set properly. Object is set to None because the File
menu is Internet Explorer's when the Active Document application is hosted.
9. Check the other menu prompts:
- The Edit prompt should have defaulted to None for Container and to Left
for Object. Object is okay, however, you need to change Container to Left
so that the FoxPro Edit menu is available if the Active Document is run
when not hosted.
- The Colors menu is not from the Quick Menu. First, add ALT+C as the
shortcut keys. Make both the Container and Object Negotiate as Middle for
Colors.
- The Program prompt should have defaulted to Middle for Container and to
Left for Object.
- The Window prompt should have defaulted to Right for Container and to Left
for Object.
- The Help prompt will need to be changed. The prompt should be set to None
for Container and to Right for Object. Change the Container to Right (so
it shows up in FoxPro) and to None for Object. The Fruit menu will be
merged with the Active Document host's Help menu. There can only be one
menu set to Negotiate Right when the menu is hosted.
- For the Fruits prompt, set the shortcut keys to ALT+U. Next, change the
Negotiate options to Right for both the Container and Object.
10. Preview the menu to see how it looks in Visual FoxPro.
11. After previewing the menu, from the System menu, point to Menu and then
click Generate to create the .mpr file.
12. Build the menu into an Active Document application, like the sample Active
Document application that can be created using the Microsoft Knowledge Base
article listed in the REFERENCES section below. Refer to step five in that
article for information on the program code to include the menu in the
application. Test the menu prompts when the Active Document application is
hosted in Internet Explorer.
13. When the Active Document application with the menu is running hosted in
Internet Explorer, notice what menus are there and which Application they
come from. The following list should be what is observed:
File menu: Internet Explorer
Edit menu: Visual FoxPro
Program menu: Visual FoxPro
Window menu: Visual FoxPro
Colors: From the sample menu
Go: Internet Explorer
Favorites: Internet Explorer
Help: Internet Explorer
14. Look at the bottom of the Help menu. There should be a prompt there with a
submenu. The text of the prompt should be ActiveDoc1 Help. This text can be
created by setting the Caption property of the ActiveDoc class that is the
main program in the project. If the sample Active Document application from
the Microsoft Knowledge Base article is being used, open the project, edit
the ADTest class and change the caption property (use Fruit as a test).
Rebuild the application and run it hosted. The menu prompt should now show
Fruit Help, assuming Fruit is the new caption.
For more information on Active Documents and Menu Negotiation, follow the
instructions below to get into the Active Documents section of the Visual FoxPro
"Programmer's Guide."
Steps to Active Documents Topic
-------------------------------
1. In the MSDN Library for Visual Studio 6.0, open the Visual FoxPro
Documentation book, and go to the What's New in Visual FoxPro page. The
Active Documents topic from the "Programmer's Guide" should be the second
item listed.
2. Click Active Documents to go to the Active Documents section of Chapter 31,
"Interoperability and the Internet"
REFERENCES
==========
For additional information on Active Documents, please see the following article
in the Microsoft Knowledge Base:
Q182579 HOWTO: Get Started With Active Documents
Visual FoxPro Online Help, version 6.0; Search on "Active Documents"; Topic:
Creating
Additional query words:
======================================================================
Keywords :
Technology : kbVFPsearch kbAudDeveloper kbVFP600
Version : WINDOWS:6.0
Issue type : kbhowto
=============================================================================
THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS
PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS
ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO
EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES
SO THE FOREGOING LIMITATION MAY NOT APPLY.
Copyright Microsoft Corporation 1999.