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) $.