NAME

MSIE::MenuExt - Generates registry file (.reg) for MSIE Menu Extension

SYNOPSIS

  use CGI;
  use MSIE::MenuExt;

  my $action = MSIE::MenuExt::Action->new();
  $action->title('Blog It!');
  $action->accesskey('B');
  $action->action('javascript:external.menuArguments.blahblah()');
  $action->context(MENUEXT_DEFAULT + MENUEXT_TEXT_SELECTIONS);

  my $reg = MSIE::MenuExt->new();
  $reg->add_action($action);

  print CGI::header(-type => 'text/plain; name=blogit.reg',
                    -content_disposition => 'attachment; filename=blogit.reg');
  print $reg->content();

This example would print

  REGEDIT4
  [HKEY_CURRENT_USER\Software\Microsoft\Internet Explorer\MenuExt\&Blog It!]
  @="javascript:external.menuArguments.blahblah()"
  "contexts"=hex:11

DESCRIPTION

MSIE::MenuExt is a module to create Win32 registry file (.reg) to register an action to Microsoft IE's Menu Extension.

METHODS

new
  my $reg = MSIE::MenuExt->new();
  my $reg = MSIE::MenuExt->new(@actions);

constructs new MSIE::MenuExt object. If MSIE::MenuExt::Action objects are given, it automaticaly calls add_action().

add_action
  $reg->add_action($action);

takes MSIE::MenuExt::Action object.

clear_action
  $reg->clear_action();

clears action objects holded inside.

content
  my $text = $reg->content();

returns content of the registry file as a string.

MSIE::MenuExt::Action METHODS

new
  my $action = MSIE::MenuExt::Action->new();
  my $action = MSIE::MenuExt::Action->new({
      title => 'Blog It!', acceskey => 'B',
      action => 'C:\file\js.htm', context => MENUEXT_DEFAULT,
  });

constructs new MSIE::MenuExt::Action object. If hash reference is given, it sets these variables as a initial state.

title
  my $title = $action->title();
  $action->title($title);;

gets/sets the title of the action, which is displayed in a menu extension.

accesskey
  my $key = $action->accesskey();
  $action->accesskey($key);

gets/sets the accesskey of the action, which you can use for a shortcut to the action. It uses the 1st string of its title attribute as a default.

action
  my $act = $action->action();
  $action=>action($act);

gets/sets the associated action, which can be a path of the executable file or script.

context
  my $context = $action->context();
  $action->context($context);

gets/sets the context where the action can be executed. The following constants can be used.

  MENUEXT_DEFAULT
  MENUEXT_IMAGES
  MENUEXT_CONTROLS
  MENUEXT_TABLES
  MENUEXT_TEXT_SELECTIONS
  MENUEXT_ANCHORS

If you put your actions in several contexts, just sum these context constants like:

  $action->context(MENUEXT_DEFAULT + MENUEXT_TEXT_SELECTIONS);

AUTHOR

Tatsuhiko Miyagawa <miyagawa@bulknews.net>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

http://www.siteexperts.com/tips/hj/ts01/index.asp