Merge pull request MicrosoftDocs#1741 from msebolt/resource-file-consolidation-pr42

resource file consolidation pr42

Author: TrishaMc

.openpublishing.redirection.json

@@ -7880,6 +7880,16 @@
             "redirect_url": "/cpp/windows/icons-and-cursors-image-resources-for-display-devices-image-editor-for-icons",
             "redirect_document_id": false
         },
+        {
+            "source_path": "docs/windows/creating-a-submenu.md",
+            "redirect_url": "/cpp/windows/creating-a-menu",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/windows/creating-pop-up-menus.md",
+            "redirect_url": "/cpp/windows/creating-a-menu",
+            "redirect_document_id": false
+        },
         {
             "source_path": "docs/windows/activationfactory-activationfactory-constructor.md",
             "redirect_url": "/cpp/windows/activationfactory-class#activationfactory",

docs/windows/TOC.md

@@ -82,9 +82,7 @@
 ##### [Icons and Cursors: Image Resources for Display Devices (Image Editor for Icons)](icons-and-cursors-image-resources-for-display-devices-image-editor-for-icons.md)
 ##### [Accelerator Keys (Image Editor for Icons)](accelerator-keys-image-editor-for-icons.md)
 #### [Menu Editor](menu-editor.md)
-##### [Creating a Menu](creating-a-menu.md)
-##### [Creating a Submenu](creating-a-submenu.md)
-##### [Creating Pop-up Menus](creating-pop-up-menus.md)
+##### [Creating Menus](creating-a-menu.md)
 ##### [Editing Multiple Menus or Menu Commands](selecting-multiple-menus-or-menu-commands.md)
 ##### [Associating Menu Commands](associating-a-menu-command-with-an-accelerator-key.md)
 ##### [Menu Command Properties](menu-command-properties.md)

docs/windows/creating-a-menu.md

@@ -1,11 +1,11 @@
 ---
-title: "Creating a Menu (C++)"
+title: "Creating Menus (C++)"
 ms.date: "11/04/2016"
 f1_keywords: ["vc.editors.menu"]
-helpviewer_keywords: ["mnemonics [C++], associating menu items", "menus [C++], associating commands with mnemonic keys", "menus [C++], creating", "menus [C++], adding items", "commands [C++], adding to menus", "menu items, adding to menus"]
+helpviewer_keywords: ["mnemonics [C++], associating menu items", "menus [C++], associating commands with mnemonic keys", "menus [C++], creating", "menus [C++], adding items", "commands [C++], adding to menus", "menu items, adding to menus", "submenus", "submenus [C++], creating", "menus [C++], creating", "context menus [C++], Menu Editor", "pop-up menus [C++], creating", "menus [C++], pop-up", "menus [C++], creating", "shortcut menus [C++], creating", "pop-up menus [C++], displaying", "pop-up menus [C++], connecting to applications", "context menus [C++], connecting to applications", "shortcut menus [C++], connecting to applications", "pop-up menus"]
 ms.assetid: 66f94448-9b97-4b73-bf97-10d4bf87cc65
 ---
-# Creating a Menu (C++)
+# Creating Menus (C++)
 
 > [!NOTE]
 > The **Resource Window** is not available in Express editions.
@@ -33,6 +33,14 @@ For information on adding resources to managed projects, see [Resources in Deskt
    > [!NOTE]
    > To create a single-item menu on the menu bar, set the **Popup** property to **False**.
 
+## To create a submenu
+
+1. Select the menu command for which you want to create a submenu.
+
+1. In the **New Item** box that appears to the right, type the name of the new menu command. This new command will appear first on the submenu menu.
+
+1. Add additional menu commands to the submenu menu.
+
 ## To insert a new menu between existing menus
 
 Select an existing menu name and press the **Insert** key. The **New Item** box is inserted before the selected item.
@@ -70,10 +78,57 @@ Right-click on the menu bar and choose **Insert New** from the shortcut menu.
 
    The new item box is selected so you can create additional menu commands.
 
+## To create pop-up menus
+
+[Pop-up menus](../mfc/menus-mfc.md) display frequently used commands. They can be context sensitive to the location of the pointer. Using pop-up menus in your application requires building the menu itself and then connecting it to application code.
+
+Once you've created the menu resource, your application code needs to load the menu resource and use [TrackPopupMenu](/windows/desktop/api/winuser/nf-winuser-trackpopupmenu) to cause the menu to appear. Once the user has dismissed the pop-up menu by selecting outside it, or has selected a command, that function will return. If the user chooses a command, that command message will be sent to the window whose handle was passed.
+
+### To create a pop-up menu
+
+1. [Create a menu](../windows/creating-a-menu.md) with an empty title (don't provide a **Caption**).
+
+1. [Add a menu command to the new menu](../windows/adding-commands-to-a-menu.md). Move to the first menu command below the blank menu title (the temporary caption says `Type Here`). Type a **Caption** and any other information.
+
+   Repeat this process for any other menu commands in the pop-up menu.
+
+1. Save the menu resource.
+
+### To connect a pop-up menu to your application
+
+1. Add a message handler for WM_CONTEXTMENU (for example). For more information, see [Mapping Messages to Functions](../mfc/reference/mapping-messages-to-functions.md).
+
+1. Add the following code to the message handler:
+
+    ```cpp
+    CMenu menu;
+    VERIFY(menu.LoadMenu(IDR_MENU1));
+    CMenu* pPopup = menu.GetSubMenu(0);
+    ASSERT(pPopup != NULL);
+    pPopup->TrackPopupMenu(TPM_LEFTALIGN | TPM_RIGHTBUTTON, point.x, point.y, AfxGetMainWnd());
+    ```
+
+   > [!NOTE]
+   > The [CPoint](../atl-mfc-shared/reference/cpoint-class.md) passed by the message handler is in screen coordinates.
+
+   > [!NOTE]
+   > Connecting a pop-up menu to your application requires MFC.
+
+### To view a menu resource as a pop-up menu
+
+Normally, when you're working in the **Menu** editor, a menu resource is displayed as a menu bar. However, you might have menu resources that are added to the application's menu bar while the program is running.
+
+Right-click the menu and choose **View as Popup** from the shortcut menu.
+
+   This option is only a viewing preference and won't modify your menu.
+
+   > [!NOTE]
+   > To change back to the menu-bar view, click **View as Popup** again (which removes the check mark and returns your menu-bar view).
+
 ## Requirements
 
 Win32
 
-## See Also
+## See also
 
 [Menu Editor](../windows/menu-editor.md)