Click here to Skip to main content
15,868,016 members
Articles / Programming Languages / C#
Article

Simple shell context menu

Rate me:
Please Sign up or sign in to vote.
4.82/5 (37 votes)
14 Aug 20062 min read 353.9K   5.7K   140   55
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.

Image 1

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.

Image 2

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.

C#
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.

C#
// 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.

C#
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:

Image 3

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


Written By
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

 
QuestionRegistry Privileges Pin
/randz5-Feb-07 21:28
/randz5-Feb-07 21:28 
GeneralHelp- Not getting context menu [modified] Pin
Venkatesh.P1-Jan-07 18:59
Venkatesh.P1-Jan-07 18:59 
GeneralRe: Help- Not getting context menu Pin
dfer28-Jan-07 11:23
dfer28-Jan-07 11:23 
GeneralRe: Help- Not getting context menu Pin
DougFolland13-Feb-08 10:12
DougFolland13-Feb-08 10:12 
GeneralHeader files Pin
Venkatesh.P28-Dec-06 20:35
Venkatesh.P28-Dec-06 20:35 
GeneralRe: Header files Pin
dfer28-Jan-07 10:56
dfer28-Jan-07 10:56 
QuestionWhy not continue for other funny features? Pin
dfer24-Nov-06 6:25
dfer24-Nov-06 6:25 
QuestionHow to unregister a menu item? Pin
dfer22-Nov-06 17:05
dfer22-Nov-06 17:05 
Thx!
AnswerRe: How to unregister a menu item? Pin
Ralph Arvesen23-Nov-06 1:25
Ralph Arvesen23-Nov-06 1:25 
GeneralRe: How to unregister a menu item? Pin
dfer24-Nov-06 6:59
dfer24-Nov-06 6:59 
GeneralRe: How to unregister a menu item? Pin
Jason Coggins6-Sep-08 2:20
Jason Coggins6-Sep-08 2:20 
QuestionHow about *.*? Pin
dfer22-Nov-06 17:04
dfer22-Nov-06 17:04 
AnswerRe: How about *.*? Pin
Ralph Arvesen23-Nov-06 1:23
Ralph Arvesen23-Nov-06 1:23 
QuestionRe: How about *.*?Need details. Pin
dfer24-Nov-06 1:34
dfer24-Nov-06 1:34 
GeneralRe: How about *.*? Pin
dfer25-Nov-06 23:38
dfer25-Nov-06 23:38 
AnswerRe: How about *.*? Pin
Ian Uy13-Nov-07 21:04
Ian Uy13-Nov-07 21:04 
GeneralLove you~go on,please. Pin
dfer17-Oct-06 16:38
dfer17-Oct-06 16:38 

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

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