The Old New Thing

Code - The Old New Thing

How to host an IContextMenu, part 11 – Composite extensions – composition

October 7, 2004 Oct 7, 2004 10/7/04
Raymond Chen
Okay, now that we have two context menu handlers we want to compose (namely, the "real" one from the shell namespace and a "fake" one that contains bonus commands we want to add), we can use merge them together by means of a composite context menu handler. The kernel of the composite context menu is to multiplex multiple context menus onto ...

How to host an IContextMenu, part 9 – Adding custom commands

October 4, 2004 Oct 4, 2004 10/4/04
Raymond Chen
The indexMenu, idCmdFirst and idCmdLast parameters to the IContextMenu::QueryContextMenu method allow you, the host, to control where in the context menu the IContextMenu will insert its commands. To illustrate this, let's put two bonus commands on our context menu, with the boring names "Top" and "Bottom". We need to reserve some space in...

How to host an IContextMenu, part 8 – Optimizing for the default command

October 1, 2004 Oct 1, 2004 10/1/04
Raymond Chen
There is a small improvement that can be made to to the program we wrote last time. It involves taking advantage of the last parameter to the IContextMenu::QueryContextMenu method: CMF_DEFAULTONLY This flag is set when the user is activating the default action, typically by double-clicking. This flag provides a hint for the shortcut menu...

How to host an IContextMenu, part 7 – Invoking the default verb

September 30, 2004 Sep 30, 2004 09/30/04
Raymond Chen
When we last left our hero, we were wondering how to invoke the default verb programmatically. Now that we've learned a lot about how IContextMenu is used in the interactive case, we can use that information to guide us in its use in the noninteractive case. The key here is using the HMENU to identify the default menu item and just invoke...

How to host an IContextMenu, part 6 – Displaying menu help

September 28, 2004 Sep 28, 2004 09/28/04
Raymond Chen
One of the subtleties of context menus is showing help in the status bar. Now, the program we've been developing doesn't have a status bar, so we'll fake it by putting the help text in the title bar. The key method for this task is IContextMenu::GetCommandString, which allows communication with a context menu handler about the verbs in ...

How to host an IContextMenu, part 5 – Handling menu messages

September 27, 2004 Sep 27, 2004 09/27/04
Raymond Chen
One bug that was called out immediately in our first attempt at displaying the context menu to the user is that the Open With and Send To submenus don't work. The reason for this is that these submenus are delay-generated (which explains why they don't contain anything interesting when you expand them) and owner-drawn (which you can't ...

How to host an IContextMenu, part 4 – Key context

September 24, 2004 Sep 24, 2004 09/24/04
Raymond Chen
Another of the bugs you may have noticed in our first attempt at displaying the context menu to the user is that the Delete command doesn't alter its behavior depending on whether you hold the shift key. Recall that holding the shift key changes the behavior of the Delete command, causing it to delete a file immediately instead of moving ...

How to host an IContextMenu, part 3 – Invocation location

September 23, 2004 Sep 23, 2004 09/23/04
Raymond Chen
One of the bugs you may have noticed in our first attempt at displaying the context menu to the user is that the Properties dialog doesn't show up at the point you clicked. The Properties dialog isn't psychic; it doesn't know where the original mouse click occurred. You have to tell it. CMINVOKECOMMANDINFOEX info = { 0...

How to host an IContextMenu, part 2 – Displaying the context menu

September 22, 2004 Sep 22, 2004 09/22/04
Raymond Chen
Instead of invoking a fixed verb, we'll ask the user to choose from the context menu and invoke the result. Make these changes to the OnContextMenu function: #define SCRATCH_QCM_FIRST 1 #define SCRATCH_QCM_LAST 0x7FFF #undef HANDLE_WM_CONTEXTMENU #define HANDLE_WM_CONTEXTMENU(hwnd, wParam, lParam, fn) \ ((fn)((hwnd), (HWND)(wParam...