MailAddress @Command (Formula Language)

Displays the Select Addresses dialog box, where the user can select people and groups to include in an address field of a mail document.

Syntax

@Command( [MailAddress] ; sendToField ; copyToField ; blindCopyToField )

Parameters

sendToField

Text. Optional. The name of the To: field of the mail document.

copyToField

Text. Optional. The name of the Cc: field of the mail document.

blindCopyToField

Text. Optional. The name of the Bcc: field of the mail document.

Usage

For MailAddress to execute successfully, a mail document must be open in Edit mode, and the insertion point must be in an editable field.

The dialog box that displays is a dialog resource built into the core Notes® program components, but it is based on the ($PeopleGroupsFlat) view in the local Address book or the server directory, depending on which is selected for use.

If you omit an address field that exists in the mail document, such as the To: field, the Select Addresses dialog box still displays the field and allows the user to specify a value for the field, but the value is not added to the field in the mail document.

Note that the Select Addresses dialog box displays only the fields that exist in the mail document; specifying a field that does not exist has no effect. For example, if the mail document is based on a form that does not include a Bcc: field, the Bcc: field does not appear in the Select Addresses dialog box, regardless of whether or not you specify the field with this command.

This command does not work on the Web.

Examples

This formula, when added to the "Address" action button on the "Memo" form in a mail database, displays the Select Addresses dialog box when an editable field is selected and the "Address" action button is clicked. A user can select addresses from his or her address books and Notes® populates the editable field with the addresses selected.
@Command([MailAddress])