/ 
Win32-ShellExt-0.1
River stage zero No dependents
++
 / Win32::ShellExt::ColumnProvider

NAME

Win32::ShellExt - Perl module for implementing context menu extensions of the Windows Explorer

SYNOPSIS

  # Sample usage of that module:
  package Win32::ShellExt::ColumnProvider::Txt;

  use strict;
  use Win32::ShellExt::ColumnProvider;

  $Win32::ShellExt::ColumnProvider::Txt::VERSION='0.1';
  @Win32::ShellExt::ColumnProvider::Txt::ISA=qw(Win32::ShellExt::ColumnProvider);

  sub get_info_tip() {
    my $self = shift;
    "text file";
  }

  sub hkeys() {
        my $h = {
        "CLSID" => "{7952ADC6-C81A-4A95-8605-732F97535CA7}",
        "extension" => "txt",
        "package" => "Win32::ShellExt::ColumnProvider::Txt"
        };
        $h;
  }

  1;

DESCRIPTION

This module is never used directly. You always subclass it into your own package, then do a one-time invocation of the install() method on your package (to install the needed registry keys). Then you should have a new entry in the contextual menu of the Windows explorer (the files for which this menu entry appears depend on the filtering you do in the query_context_menu method), and your action() method gets called upon clicking the corresponding menu command in the Explorer.

As usual, the methods get_column_info & get_item_data map to the methods GetColumnInfo & GetItemData of the IColumnProvider interface (in <shlobj.h>).

Note the additionnal hkey entry that modules deriving from Win32::ShellExt don't have: 'extension' this is used to set up the registry entries to tell explorer which kinds of files your extension works on.

EXPORT

None by default. None needed.

AUTHOR

Jean-Baptiste Nivoit <jbnivoit@hotmail.com>

SEE ALSO

perl.