=head1 NOM

Win32::ChangeNotify - Surveillance d'événements relatifs à des fichiers et répertoires

=head1 SYNOPSIS

	require Win32::ChangeNotify;

	$notify = Win32::ChangeNotify->new($Path,$WatchSubTree,$Events);
	$notify->wait or warn "Something failed: $!\n";
	# Il y a eu un changement.

=head1 DESCRIPTION

Ce module permet au programmeur d'utiliser un objet "notification de
modification Win32" depuis Perl.
Cela permet aux programmes Perl de surveiller des événements
concernant les fichiers et les arborescences de répertoires.

La méthode C<wait> et les fonctions C<wait_all> et C<wait_any> sont
héritées du module B<Win32::IPC>. Voir L<Win32::IPC>.

=head2 Méthodes

=over 4

=item $notify = Win32::ChangeNotify->new($path, $subtree, $filter)

Constructeur d'un nouvel objet ChangeNotification. C<$path> est
le répertoire à surveiller. Si C<$subtree> est vrai, alors tous les
sous-répertoires de C<$path> seront surveillés. C<$filter> indique
quels événements doivent déclencher la notification. Ce doit être
une chaîne contenant n'importe lequel des drapeaux suivants (séparés
par des espaces et/ou C<|>).

   ATTRIBUTES   un attribut a changé
   DIR_NAME     un nom de répertoire a changé
   FILE_NAME    un nom de fichier a changé (création/effacement/renommage)
   LAST_WRITE   la date de dernière écriture d'un fichier a changé
   SECURITY     un descripteur de sécurité a changé
   SIZE         la taille d'un fichier a changé

(C<$filter> peut aussi être un entier composé avec les constantes de
C<FILE_NOTIFY_CHANGE_*>.)

=item $notify->close

Arrête la surveillance. À la place, vous pouvez juste faire C<undef $notify>
(mais C<close> fonctionne même s'il y a d'autres copies de l'objet).
Cette fonction est appelée automatiquement quand votre programme se
termine.

=item $notify->reset

Réinitialise l'objet ChangeNotification après qu'un changement ait été détecté.
L'objet sera encore déclenché au prochain changement.
(C'est OK pour l'appeler immédiatement après un C<new>, mais ce n'est pas
obligatoire.)

=item $notify->wait

Voir L<Win32::IPC>.
N'oubliez pas d'appeler ensuite C<reset> si vous voulez continuer la surveillance.

=back

=head2 Fonctions et méthodes dépréciées

B<Win32::ChangeNotify> accepte encore la syntaxe ActiveWare, mais son
utilisation est déconseillée.

=over 4

=item FindFirst($Obj,$PathName,$WatchSubTree,$Filter)

Utilisez

  $Obj = Win32::ChangeNotify->new($PathName,$WatchSubTree,$Filter)

à la place.

=item $obj->FindNext()

Use C<$obj-E<gt>reset> instead.

=item $obj->Close()

Utilisez C<$obj-E<gt>close> à la place.

=back

=head1 AUTEUR

Christopher J. Madsen E<lt>F<chris_madsen@geocities.com>E<gt>

Vaguement basé sur le module original d'ActiveWare Internet Corp.,
F<http://www.ActiveWare.com>

=head1 VERSION FRANÇAISE

Cette traduction française correspond à la version anglaise distribuée avec perl 5.6.1.
Pour en savoir plus concernant ces traductions, consultez http://www.enstimac.fr/Perl/ .

=head1 TRADUCTION EN FRANÇAIS

Jean-Louis Morel <jl_morel@bribes.org>

=cut