|OnAdd||Runs whenever a message is added to a mailbox. The message might be added as the result of a filter or script, as the result of dragging the message to the mailbox or via the "Move Message to Mailbox" item on the mailbox index context menu.||101|
|OnBounce||When a message is bounced to another user (before the message body has been formatted).||136|
|OnBounceEdit||Same as "OnBounce" except the message has already been formatted for editing.||146|
|OnCompose||When a window is opened to compose a new message.||131|
|OnDisplay||When a message is formatted for display. Changes made to a messaged by an onDisplay event filter or script affect only the message as it is displayed, not the message as it is stored in the mailbox.||121|
|OnForward||When a message is being forwarded to an individual, prior to the message text being formatted in the message.||134|
|OnForwardAtt||Forwarding a message as an attachment, before the message has been formatted.||135|
|OnForwardAttEdit||Forwarding a message as an attachment, after the message has been formatted.||145|
|OnForwardEdit||When a message is being forwarded to an individual, after the message text has been formatted in the message.||144|
|OnReply||When a reply (to the original sender) is being composed (before the text has been formatted in the reply window).||132|
|OnReplyAll||When a reply (to all recipients of the message) is being composed (before the text has been formatted in the reply window).||133|
|OnReplyAllEdit||When a reply (to all recipients of the message) is being composed (after the text has been formatted in the reply window).||143|
|OnReplyEdit||When a reply is being composed (after the text has been formatted in the compose window).||142|
|OnStartup||Runs scripts/filters when starting Poco||20|
|OnTimer||Runs scripts/filters at startup and at specific intervals thereafter.||10|
|OnQuit||Runs scripts/filters as Poco is being shutdown.||25|
|Poco 3 has a GUI interface for configuring events. Select "Tools | Events" (or Ctrl+F9) to display the form.|
|Poco 2.x provides the facility to invoke scripts in response to the above events no GUI support is
provided for configuring which scripts will be launched in response to the event. This must be done by
manually editing the Poco configuration files.
Be sure to shutdown Poco before making any of these changes!
Events can be specified on
When events are defined across multiple levels then all events will be executed with the mailbox specific ones executing before folder level which are in turn before application wide events.
Regardless of the level of the event the syntax of the specification is the same. At the bottom of the respective file enter [Events] on a new line to indicate the start of the event specification section. On following lines define the scripts to be executed and the events they are to be executed for using the following syntax:
EventType_Scripts=script1,script2,script3For example, to specify that the Reformat and InsertWittyComment scripts are to run when you reply to a message in your "Friends" folder you would create a "folder.ini" file containing the following lines and place it in the "Friends" folder:
Folder level events are executed after mailbox level events but before application wide events.
Mailbox level events are executed before both folder level and application wide events.
In general you need to follow the same rules for specifying scripts for use in events. For the most part you will want to run a set of manual filters in response to the event. The syntax for the specification differs as follows:
You need to tell Poco that you want to run a set of filters rather than a script; use the following syntax:
Where "n" is a number specifying the set of filters you want to run as outlined in the following table: