Click here to Skip to main content
Click here to Skip to main content

Simple shell context menu

, 14 Aug 2006
Rate this:
Please Sign up or sign in to vote.
Demonstrates how to create a simple shell context menu using a few registry entries, instead of COM. The sample context menu creates a grayscale copy of the selected JPEG image.

Introduction

Shell context menus are displayed when you right click on shell objects such as files and folders. A full-blown context menu is a COM object that implements the IContextMenu and IShellExtInt interfaces. This article demonstrates how to create a simple shell context menu (also called a shortcut menu) that does not require COM and only requires a few registry entries.

Registry entries

You can hookup a context menu to any file type by adding entries under the HKEY_CLASSES_ROOT\<file type>\shell registry location. For example, the following registry script adds the Register and Unregister context menus to DLL files.

REGEDIT4

[HKEY_CLASSES_ROOT\dllfile\shell]
[HKEY_CLASSES_ROOT\dllfile\shell\Register]
[HKEY_CLASSES_ROOT\dllfile\shell\Register\command]
@="regsvr32 \"%L\""

[HKEY_CLASSES_ROOT\dllfile\shell\Unregister]
[HKEY_CLASSES_ROOT\dllfile\shell\Unregister\command]
@="regsvr32 /u \"%L\""

A view of the registry is shown below. The HKEY_CLASSES_ROOT\dllfile\shell key contains the list of context menus for DLL files. The Register and Unregister keys are two of the menus for DLL files (these also specify the menu text since a default value is not specified). The default value of the command key specifies the command line that is executed when the context menu is invoked. The %L argument is a placeholder to the full path of the selected item. You can read more about the registry settings at the MSDN article: Extending Shortcut Menus.

Registering and un-registering

The sample application contains the FileShellExtension class that registers and un-registers a simple shell context menu. The Register method creates the necessary registry entries, and the Unregister method removes the registry entries.

static class FileShellExtension
{
    public static void Register(string fileType,
           string shellKeyName, string menuText, string menuCommand)
    {
        // create path to registry location
        string regPath = string.Format(@"{0}\shell\{1}", 
                                       fileType, shellKeyName);

        // add context menu to the registry
        using (RegistryKey key = 
               Registry.ClassesRoot.CreateSubKey(regPath))
        {
            key.SetValue(null, menuText);
        }

        // add command that is invoked to the registry
        using (RegistryKey key = Registry.ClassesRoot.CreateSubKey(
            string.Format(@"{0}\command", regPath)))
        {
            key.SetValue(null, menuCommand);
        }
    }

    public static void Unregister(string fileType, string shellKeyName)
    {
        Debug.Assert(!string.IsNullOrEmpty(fileType) &&
            !string.IsNullOrEmpty(shellKeyName));

        // path to the registry location
        string regPath = string.Format(@"{0}\shell\{1}", 
                                       fileType, shellKeyName);

        // remove context menu from the registry
        Registry.ClassesRoot.DeleteSubKeyTree(regPath);
    }
}

The sample application self-registers when executed without any command line arguments, or with the -register command; it unregisters when the -unregister command is specified. The usage of the FileShellExtension class is shown below.

// sample usage to register
// get full path to self, %L is a placeholder for the selected file
string menuCommand = string.Format("\"{0}\" \"%L\"", 
                                   Application.ExecutablePath);
FileShellExtension.Register("jpegfile", "Simple Context Menu", 
                            "Copy to Grayscale", menuCommand);

// sample usage to unregister
FileShellExtension.Unregister("jpegfile", "Simple Context Menu");

Creating a grayscale image

The CopyGrayscaleImage method is called when the context menu is clicked. The ColorMatrix class is used to generate a grayscale copy of the selected image.

static void CopyGrayscaleImage(string filePath)
{
    // full path to the grayscale copy
    string grayFilePath = Path.Combine(
        Path.GetDirectoryName(filePath),
        string.Format("{0} (grayscale){1}",
        Path.GetFileNameWithoutExtension(filePath),
        Path.GetExtension(filePath)));

    // using calls Dispose on the objects, important
    // so the file is not locked when the app terminates
    using (Image image = new Bitmap(filePath))
    using (Bitmap grayImage = new Bitmap(image.Width, image.Height))
    using (Graphics g = Graphics.FromImage(grayImage))
    {
        // setup grayscale matrix
        ImageAttributes attr = new ImageAttributes();
        attr.SetColorMatrix(new ColorMatrix(new float[][]{
            new float[]{0.3086F,0.3086F,0.3086F,0,0},
            new float[]{0.6094F,0.6094F,0.6094F,0,0},
            new float[]{0.082F,0.082F,0.082F,0,0},
            new float[]{0,0,0,1,0,0},
            new float[]{0,0,0,0,1,0},
            new float[]{0,0,0,0,0,1}}));

        // create the grayscale image
        g.DrawImage(image, new Rectangle(0, 0, image.Width, image.Height),
            0, 0, image.Width, image.Height, GraphicsUnit.Pixel, attr);

        // save to the file system
        grayImage.Save(grayFilePath, ImageFormat.Jpeg);
    }
}

The original and generated grayscale images are shown below:

Running the sample

The sample was built with Visual Studio 2005, and requires the .NET Framework 2.0; however, the ideas can easily be incorporated into any .NET version and language. You can do the following to run the sample:

  • Build and run the application. This registers the context menu by adding the HKEY_CLASSES_ROOT\jpegfile\shell\Simple Context Menu key to the registry.
  • Right click on a JPEG file, you should see a new Copy to Grayscale context menu.
  • Click the context menu to create a grayscale copy of the image.
  • Unregister the context menu by running SimpleContextMenu.exe –unregister.

Context menus for all files, folders, and drives

You can also hookup context menus to all files, folders, and drives by adding entries to the file type's *, Directory, and Drive registry keys. For example, XP PowerToys adds the Open Command Window Here menu to all folders with the following registry script:

REGEDIT4

[HKEY_CLASSES_ROOT\Directory\shell\cmd]
@="Open Command Window Here"

[HKEY_CLASSES_ROOT\Directory\shell\cmd\command]
@="cmd.exe /k \"cd %L\""

Simple context menus do have limitations, such as only accepting one file on the command line, but they are still pretty useful. I'll cover creating a full-blown .NET COM-based context menu in a future article.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author

Ralph Arvesen
Web Developer
United States United States
Ralph Arvesen is a software engineer for Vertigo Software and has worked on desktop, web and Pocket PC applications using .NET and C++. Before Vertigo, he designed hardware and firmware for optical inspection systems and has been developing software for the Microsoft platform since Windows 2.0. He co-authored several books and worked as technical editor on others. Ralph lives in the Texas Hill Country west of Austin; his personal site is located at www.lostsprings.com.

Comments and Discussions

 
QuestionHow can i implement in WPF [modified] Pinmemberkarthikin15-Mar-14 7:13 
QuestionAccess denied PinmemberMojtaba026-Jan-14 1:36 
GeneralMy vote of 5 PinmemberLord Codemonger3-May-13 8:59 
QuestionHow to save excel file path? PinmemberKhuc Manh Thao28-Feb-12 15:52 
QuestionHow to make work on 64-bit? PinmemberMember 30938448-Dec-11 3:45 
QuestionOn WinXP fine | On Win7 it does not work PinmemberDiabloPB16-Oct-11 22:09 
QuestionHow do you do this for a custom file type e.g. *.ttr files Pinmemberkommand17-Nov-10 6:36 
GeneralGreat Job! Pinmemberoldsellerros17-Nov-09 11:32 
QuestionWhat about custom icon? PinmemberWizard_Memfis2-Sep-09 10:48 
QuestionThe * didn't works well ??? PinmemberAdore C++13-Jun-09 9:18 
GeneralDoesn't work in Vista64bit PinmemberGreg Cadmes22-Jan-09 18:39 
GeneralRegistry shell command for dll not working on vista PinmemberPaul Shaffer15-Jan-09 20:13 
GeneralExcellent Example !!! Pinmemberfer_cyberlinklabs8-Oct-08 8:46 
GeneralUsing this with a .wav file PinmemberJason Coggins8-Sep-08 2:17 
GeneralRe: Using this with a .wav file PinmemberSuleyman Arslan7-Oct-08 10:29 
QuestionHow add conditionally enable context menu PinmemberAltaf Navalur27-Jun-08 20:30 
QuestionHow to make multiple file selections? Pinmembermasfenix9-Apr-08 11:46 
AnswerRe: How to make multiple file selections? Pinmemberdhsc22-Oct-09 4:20 
GeneralRe: How to make multiple file selections? PinmemberPham Huy Anh27-Jan-10 1:28 
GeneralRegistry Entry throught Setup And Deployment Project PinmemberMohantaD23-Nov-07 6:55 
QuestionRe: Registry Entry throught Setup And Deployment Project Pinmemberadriaan van heerden16-Oct-08 2:24 
GeneralPlease help PinmemberAbhishek sur16-Oct-07 2:52 
GeneralVista PinmemberDanauktion.net29-Sep-07 23:44 
GeneralRe: Vista PinmemberPhilipTyphe28-Feb-08 19:16 
GeneralRe: Vista Pinmemberneo2-0x@o2.pl27-Jul-08 3:40 
QuestionDesktop Context item? Pinmemberstudent_rhr22-Jul-07 5:54 
GeneralNo context menu PinmemberTOMCAT8126-Feb-07 3:59 
QuestionAdd sub-menu item under "SendTo..." Pinmemberdfererer16-Feb-07 16:16 
AnswerRe: Add sub-menu item under "SendTo..." Pinmemberradialronnie29-May-08 5:44 
GeneralRe: Add sub-menu item under "SendTo..." Pinmemberdfer29-May-08 9:38 
QuestionRegistry Privileges Pinmembersheijin5-Feb-07 21:28 
GeneralHelp- Not getting context menu [modified] PinmemberVenkatesh.P1-Jan-07 18:59 
GeneralRe: Help- Not getting context menu Pinmemberdfer28-Jan-07 11:23 
GeneralRe: Help- Not getting context menu PinmemberDougFolland13-Feb-08 10:12 
GeneralHeader files PinmemberVenkatesh.P28-Dec-06 20:35 
GeneralRe: Header files Pinmemberdfer28-Jan-07 10:56 
QuestionWhy not continue for other funny features? Pinmemberdfer24-Nov-06 6:25 
QuestionHow to unregister a menu item? Pinmemberdfer22-Nov-06 17:05 
AnswerRe: How to unregister a menu item? PinmemberRalph Arvesen23-Nov-06 1:25 
GeneralRe: How to unregister a menu item? Pinmemberdfer24-Nov-06 6:59 
GeneralRe: How to unregister a menu item? PinmemberJason Coggins6-Sep-08 2:20 
QuestionHow about *.*? Pinmemberdfer22-Nov-06 17:04 
AnswerRe: How about *.*? PinmemberRalph Arvesen23-Nov-06 1:23 
QuestionRe: How about *.*?Need details. Pinmemberdfer24-Nov-06 1:34 
GeneralRe: How about *.*? Pinmemberdfer25-Nov-06 23:38 
AnswerRe: How about *.*? PinmemberIan Uy13-Nov-07 21:04 
GeneralLove you~go on,please. Pinmemberdfer17-Oct-06 16:38 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web02 | 2.8.140827.1 | Last Updated 14 Aug 2006
Article Copyright 2006 by Ralph Arvesen
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid