NAME
Mail::Outlook::Folder - extension to handle Microsoft (R) Outlook (R) mail folders.
SYNOPSIS
See Mail::Outlook, as this is not meant to be used as a standalone module.
DESCRIPTION
Handles the Folder interaction with the Outlook API.
METHODS
- new()
-
Create a new Outlook mail object. Returns the object on success or undef on failure. To see the last error use 'Win32::OLE->LastError();'.
- DESTROY
-
Empty sub
- first()
-
Gets the first message object in the current folder. Returns undef if no messages.
- last()
-
Gets the last message object in the current folder. Returns undef if no messages.
- next()
-
Gets the next message object in the current folder. Returns undef if no more messages. Must be called after a first() or last() has been intiated.
- previous()
-
Gets the previous message object in the current folder. Returns undef if no more messages. Must be called after a first() or last() has been intiated.
- move($message)
-
Move a message into this folder.
- move_folder($folder)
-
Move a folder into this folder.
- delete_folder()
-
Remove this folder.
- all_folders
-
List the names of all folders in this folder.
- count_items
-
Return the number of items in the folder.
#=head1 FURTHER READING
#If you intend to supply a patch for a bug or new feature, please visit the #following URL (and associated pages) to ensure you are using the correct #objects and methods.
#http://msdn.microsoft.com/library/default.asp?url=/library/en-us/off2000/html/olobjApplication.asp
#This article contains some interesting background into creating mail #messages via Outlook, although it is VB-centric.
#http://www.exchangeadmin.com/Articles/Index.cfm?ArticleID=4657
#=head1 FUTURE ENHANCEMENTS
#A couple of items that I'd like to get working.
#* X-Header support #* Send without the popups (Outlook Redemption looks possible)
NOTES
This module is intended to be used on Win32 platforms only, with Microsoft (R) Outlook (R) installed.
Microsoft and Outlook are registered trademarks and the copyright 1995-2003
of Microsoft Corporation.
SEE ALSO
Win32::OLE
Win32::OLE::Const
BUGS, PATCHES & FIXES
There are some minor items under "Issues" , but there are no known serious bugs at the time of this release.
However, if you spot a bug or are experiencing difficulties that are not explained within the POD documentation, please submit a bug to the RT system (see link below). However, it would help greatly if you are able to pinpoint problems or even supply a patch.
Fixes are dependent upon their severity and my availability. Should a fix not be forthcoming, please feel free to (politely) remind me by sending an email to barbie@cpan.org .
RT: http://rt.cpan.org/Public/Dist/Display.html?Name=Mail-Outlook
AUTHOR
Barbie, <barbie@cpan.org>
for Miss Barbell Productions, <http://www.missbarbell.co.uk>
COPYRIGHT AND LICENSE
Copyright E<copy> 2003-2013 Barbie for Miss Barbell Productions.
Copyright E<copy> 2014-2016 Duncan Garland.
This distribution is free software; you can redistribute it and/or
modify it under the Artistic License v2.