NAME

       Gtk2::AppIndicator - Perl extension for libappindicator

SYNOPSIS

         use Gtk2 '-init';
         use Gtk2::AppIndicator;
         use Cwd;

         # Initialize the status icon. an_icon_name must be present
         # at the icon theme path location, with an image extension like
         # .jpg, .png or .svg, etc.
         $status_icon=Gtk2::AppIndicator->new("AnAppName","an_icon_name");

         # If you want to be in control over your icon location, you
         # can set it manually. It must be an absolute path, in order
         # to work.
         my $absolute_current_working_directory=getcwd();
         my $acwd=$absolute_current_working_directory;
         $status_icon->set_icon_theme_path($acwd);

         # Optionally set different icons
         # $status_icon->set_icon_name_active("an_icon_name");
         # $status_icon->set_icon_name_attention("an_other_icon_name");
         # $status_icon->set_icon_name_passive("an_other_icon_name");

         # Add a menu to the indicator
         my $menu=Gtk2::Menu->new();
         my $showcp=Gtk2::CheckMenuItem->new_with_mnemonic("_Show My App");
         $showcp->set_active(1);
         $showcp->signal_connect("toggled",sub { hide_show($window,$showcp); });
         my $quit=Gtk2::MenuItem->new_with_mnemonic("_Quit");
         $quit->signal_connect("activate",sub { Gtk->main_quit(); });

         $menu->append($showcp);
         $menu->append(Gtk2::SeparatorMenuItem->new());
         $menu->append($quit);
         $status_icon->set_menu($menu);

         # Show our icon and set the state
         $menu->show_all();
         $status_icon->set_active();

DESCRIPTION

       This module gives an interface to the new ubuntu Unity libappindicator stuff.

FUNCTIONS

        $ind=Gtk2::AppIndicator->new($application_id,$active_icon_name [,$category])

       Creates a new application indicator object with given name (id) and icon name for the
       active icon.  Category must be one of  { 'application-status', 'communications',
       'system-services', 'hardware', 'other' } if set. if not set, it defaults to
       'application-status'.

        $ind->set_icon_theme_path($path)

       Set the icon theme path to 'path'. This is where icons should be found with names like
       <active_icon_name>.png.

        $ind->get_icon_theme_path()

       Returns the (previously written) icon theme path, or undefined if not set.

        $ind->get_category()

       Returns the previously set category with the new function.

        $ind->get_id()

       Returns the application id given to the new function.

        $ind->set_icon_name_active($name)

       Sets the icon name for the active icon.

        $ind->get_icon_name_active()

       Returns the name of the icon for active state.

        $ind->set_icon_name_attention($name)

       Sets the icon name for the attention icon

        $ind->get_icon_name_attention()

       Returns the name of the icon for attention state.

         $ind->set_active()

       Makes the application indicator active.

         $ind->set_attention()

       Makes the application indicator show the attention icon.

         $ind->set_passive()

       Makes the application indicator enter passive state, not showing any icon

         $ind->set_state($state)

       Sets application indicator in the given state, one of {'active','passive','attention'}.

         $ind->get_state()

       Returns the current state of the application indicator.

         $ind->set_menu($menu)

       Sets the popup menu for the indicator icon.

         $ind->get_menu()

       Returns the current menu (not from the C code, but as stored in the perl object)

         $ind->set_secondary_activate_target($widget)

       Sets the secondary active target (under the middle mouse button) to $widget

         $ind->get_secondary_activate_target()

       Returns the current secondary active target (not from the C code, but as stored in the
       perl object)

AUTHOR

       Hans Oesterholt, <oesterhol@cpan.org>

COPYRIGHT AND LICENSE

       Copyright (C) 2012 by Hans Oesterholt <oesterhol@cpan.org>

       This program is free software; you can redistribute it and/or modify it under the terms of
       the Artistic License, which comes with Perl.