Thomas Walloschke

NAME

Win32::TSA::Notify - Win32 Taskbar Status Area Notification System

VERSION

This documentation refers to Win32::TSA::Notify Version 0.01.01 $Revision: 462 $

Precautions: Alpha Release.

SYNOPSIS

  use Win32::TSA::Notify;
  • Standard

      $icon = Win32::TSA::Notify->new();
      $icon = Win32::TSA::Notify->new( 'myApp', 500, 'MyApp' );
      $icon = Win32::TSA::Notify->new( [ qw(myApp red green myApp) ], 500, 'MyApp' );
    
      $icon->change_icon( 'app' );
      $icon->change_icon( 'app', 1000 );
      $icon->change_icon( [ qw(blue red green yellow) ] , 250 );
      $icon->remove_icon;
      
      $icon->change_text( qq(Tooltip ... etc.) );
        
      $icon->alert( 'Alert1', "Message1\nText1" );
      $icon->alert( 'Alert2', "Message2\nText2", 'info' );
      $icon->alert( 'Alert3', "Message3\nText3", 'warning', 'Attention please' );
      $icon->clear_alert;
      $self->clear_alert if $icon->alert_status;
  • PerlTray Emulation

      $icon->SetIcon( 'app' );
      $icon->SetIcon( 'app', 1000 );
      $icon->SetIcon( [ 'blue', 'red', 'green', 'yellow' ] , 250 );
      
      $icon->SetAnimation( 5000, 250, 'blue', 'red', 'green', 'yellow' );
      $icon->SetAnimation( 5000, 250, [ 'blue', 'red', 'green', 'yellow' ] );
      
      $icon->Balloon( 'Info1', 'Title1', 'warning', 3000 );
      $icon->Balloon( 'Info2', 'Title2', 'none', 5000 );

DESCRIPTION

Win32::TSA::Notify is an Win32 Taskbar Status Area Notification System.

... tdb

METHODS

  • change_icon

  • remove_icon

  • restore_icon

  • change_text

  • alert

  • clear_alert

  • alert_status

  • SetIcon(ICON)

  • SetAnimation(DURATION, FREQUENCY, ICONS)

  • Balloon(INFO, TITLE, ICON, TIMEOUT)

EXAMPLE

See source file exe/Win32-TSA-Notify.pl, packer configuration file exe/Win32-TSA-Notify.perlapp and test executable files exe/Win32-TSA-Notify.exe and exe/Win32-TSA-Notify.bat of this distribution.

CREDITS

The module Win32::TSA::Notify is based on code written by Dave Roth and was rewritten by Thomas Walloschke.

Significant inspiration comes from code in

'How to Script In-Your-Face Alerts - A TSA notification system' (http://www.windowsitpro.com/Article/ArticleID/45195/45195.html), application example in 45195.zip written by Dave Roth (http://www.roth.net).

SEE ALSO

Win32::API::Prototype at http://www.roth.net/perl/prototype/

Win32::PerlExe::Env at http://www.cpan.org

AUTHOR

<Thomas Walloschke (thw@cpan.org)>.

COPYRIGHT AND LICENSE

Copyright (c) 2006 Thomas Walloschke (thw@cpan.org).

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

DATE

Last changed $Date: 2006-09-01 02:05:08 +0200 (Fr, 01 Sep 2006) $.

5 POD Errors

The following errors were encountered while parsing the POD:

Around line 429:

'=item' outside of any '=over'

Around line 460:

You forgot a '=back' before '=head1'

Around line 468:

'=item' outside of any '=over'

Around line 488:

You forgot a '=back' before '=head1'

Around line 520:

Unknown directive: =head