Error getting tags :
error 404Error getting tags :
error 404 revMail | revDocs | RunRev
Welcome Guest (Log in)
Product Edition
Expander triangle
revMail address[,ccAddress[,mailSubject[,messageBody]]]
Desktop, Web and Server
Platform Support
MacOS,Mac OS X,Windows,Linux
None required
Opens a new email message in the user's email program.

revMail ""
revMail "",,"Help!",field "Message"
revMail "","","Installation Help"
revMail the bugAddress of this stack,,"Auto Bug Report",myBugsList

Additional Comments
Expander triangle

Use the revMail command to create an email message from within a stack.


The address is a string consisting of one or more email addresses, separated by commas. These addresses will appear in the To: header of the email message.

The ccAddress is a string consisting of one or more email addresses, separated by commas. These addresses will appear in the Cc: header of the email message.

The mailSubject is a string consisting of a single line. This text will appear in the Subject: header of the email message.

The messageBody is a string. This text will appear in the body of the email message.


When Revolution executes the revMail command, the user's email program is opened (if necessary) and a new email message with the specified parameters is created. The user can change any of the settings before sending the message, and the message is not sent automatically: the user must explicitly send it (for example, by clicking a "Mail" button in the email program).

On Mac OS systems, the mail message is opened in the application the user has set for the "mailto:" protocol in the Internet control panel (or, for older system versions, Internet Config).

Important! On Mac OS systems, the revMailcommand requires that AppleScript be installed and that the GURL Apple Event be supported. GURL support is included in Mac OS 8.5 or later, and is available for Mac OS 8.0 and 8.1 if the "Internet Scripting" file is installed in the "Scripting Additions" folder inside the Extensions folder. (This file is installed by the Internet Access installer on the 8.0 installation CD.) The revMailcommand is not supported for Mac OS versions before 8.0.

For some older email programs, it may not be possible to specify a ccAddress, mailSubject, or messageBody. Generally, the revMail command will still work with such programs, but only the To: header will be set.

Note: When included in a standalone application, the Common library is implemented as a hidden group and made available when the group receives its first openBackground message. During the first part of the application's startup process, before this message is sent, the revMailcommand is not yet available. This may affect attempts to use this command in startup, preOpenStack, openStack, or preOpenCardhandlers in the main stack. Once the application has finished starting up, the library is available and the revMailcommand can be used in any handler.

User Comments
Expander triangle