Shell Extension to Copy Full Filename Path(s)

A single file selection…
Shell Extension to copy path of filename

Multiple files selected…
Shell Extension to copy path of
filename

Environment: VC6 SP3, NT4 SP5, IE5

There numerous times that I’ve wished I could simply right-click on a
file, and copy its full pathname in order to paste it into an e-mail or
a file open dialog. I finally decided to write it
myself and thought someone else might find it useful. The extension adds
a ‘Copy Path’ command to the context menu for a single file/folder
selection and a ‘Copy All Paths’ command for multi-file/folder selection.
For a single selection the complete pathname of the file is simply
placed on the clipboard. For a multi-file selection, all the paths of
the files are placed on the clipboard separated by <cr><lf>
pairs.

One unexpected ‘feature’ is that you can right-click on a shortcut and the
path of the target will be copied to the clipboard. Of course, the
shortcut can be anywhere, including shell menu items if the IE4
active desktop option is installed.

Some of the code was based on code written by Dino Esposito from his book,
Visual C++ Window Shell Programming (Wrox). This is an excellent
resource for shell programming. I’ve run across a few things that his
book didn’t cover and found a bug related to a newer version of IE (I
think).

This has been tested only on NT4 SP5 with IE5, and 95 without IE.

Overview

This is not a tutorial on shell extensions. I’ll just give a brief
overview of the requirements for a shell
extension with some specifics about this example. There are several good
resources,
one of the best of which is the book I mentioned earlier by Dino Esposito,

Visual C++ Window Shell Programming
. Chris Losinger also has an
example,
Shell Extension Context Menu Sample
at CodeGuru.

I started building this component by simply creating an ATL COM
project, and then adding a simple ATL object. I then added the necessary
interfaces and their implementations. A shell extension requires
implementation
of two interfaces, IShellExtInit and IContextMenu.

IShellExtInit has only one
method, Initialize which is used to get the name of the files that
have been selected (this extension only gets the name of the file
with the current focus, although it could be expanded to be disabled if
multiple files were selected, or to put all the paths on the clipboard.)

IContextMenu has three methods to implement, GetCommandString,
InvokeCommand, and QueryContextMenu.

  • QueryContextMenu is called when the extension is first loaded to
    get the text and ID for the context menu item.
  • InvokeCommand is called when the user invokes the menu item.
  • GetCommandString can be called in different situations, but for this
    example we only care
    when it is called to get the help text associated with the command.

    I had a bit of trouble getting this to work correctly and I think it
    has to do with most recent IE installation. Following is the code
    for GetCommandString:

    
    // IContextMenu::GetCommandString
    HRESULT CCopyPathExt::GetCommandString(UINT /*idCmd*/, UINT uFlags,
     UINT* /*pwReserved*/, LPSTR pszText, UINT cchMax)
    {
     try {
      USES_CONVERSION;
       // We don't care about the command ID, since we have a
       // single item
    
       // This is rather funky, but GCS_HELPTEXTA refers to a
       // single bit (4) and GCS_UNICODE refers to single bit
       // (1), but GCS_HELPTEXTW is a combination
       // of those values (5).  This works on both NT and 95.
       if ( uFlags & GCS_HELPTEXTA ) {
        // I'm assuming that this value always contains the number
        // of bytes available for the message, just to be safe.
        // So half it for Unicode characters.
        const int cChars = cchMax / sizeof(TCHAR);
    
        // Create some storage on the stack for building the
        // help text
        LPTSTR szHelpText =
         reinterpret_cast( _alloca( cChars ) );
    
        memset( szHelpText, 0, cChars );
    
        // Create a generic version of the help text depending on
        // the number of file selected
        if ( 1 == m_cFiles ) {
         _sntprintf( szHelpText, cChars - 1,
          _T("Copy full path of file to clipboard (%s)"), m_szFile);
        } else {
         const LPTSTR szMultiFileHelpText =
          _T("Copy full paths of selected files to clipboard");
    
         _tcsncpy( szHelpText, szMultiFileHelpText, min(cChars - 1,
          _tcslen( szMultiFileHelpText ) ) );
        }
    
        // Do character conversion depending on flag
        if ( uFlags & GCS_UNICODE ) {
         wcsncpy( reinterpret_cast(pszText),
          T2W(szHelpText), cChars );
        } else {
         strncpy(pszText, T2A(szHelpText), cchMax);
        }
       }
      } catch ( ... ) {
      return E_FAIL;
     }
     return S_OK;
    }
    
  • Most examples simply test for the bits GCS_HELPTEXTA or GCS_HELPTEXTW,
    but the value of GCS_HELPTEXTW is actually 5, not a single
    bit value, which is also equal to GSC_HELPTEXTA|GCS_UNICODE. So, I
    simply test for GCS_HELPTEXTA and then test for the GCS_UNICODE bit.
    I also assume that if GetCommandString requests a Unicode string,
    then the max length of the string is half of what it would normally
    be. This may be incorrect, but it’s a safe guess.

Future work

  • There are ‘extended’ commands for the shell that are displayed when
    the user holds down the SHIFT key. For example, under NT, you’ll get
    the additional commands ‘Compress’, ‘Uncompress’, and ‘Open With…’
    (even if the file already has an association). I would like to add
    extended commands that only copy the filename(s) not the path (fewer
    keystrokes than F2, Ctrl-C, ESC). The documentation for
    IContextMenu::QueryContextMenu
    states that the CMF_EXTENDEDVERBS “…is set when the calling
    application
    wants extended verbs. Normal verbs are displayed when the user right-clicks
    an object. To display extended verbs, the user must right-click while
    pressing the SHIFT key.”
    But, I could not get this to work nor find
    any examples. Let me know if you know how to do this.
  • The bitmap for the icon gets XORed by the shell to make it look darker
    than it should. I’ve read that IContextMenu3 needs to be implemented
    to handle an ownerdraw menuitem in order to make the icons like
    as nice as the ‘Send To’ icons. A fix for this would be nice.
  • Finally, I would like to put together an ATL Object wizard to help
    jumpstart the creation of these shell extensions. I’ll do it if someone
    requests it.

Downloads

Download source and DLL – 87 Kb

More by Author

Get the Free Newsletter!

Subscribe to Developer Insider for top news, trends & analysis

Must Read