The 'attachments' property

Nested vector of character vectors, or a simple character vector or matrix

Valid for: GetMail, SendMail

The attachments property contains the list of file names which correspond to the attachments of a mail message. For the GetMail object, it is a read-only property, which is valid only after you have called the GetMessage method to retrieve the message together with the attachments. (The files are written to the directory specified in the path property, and the names are returned without the directory part). For a SendMail object, you should write to this property to set up any attachments before calling the SendMessage method. For this case, you should specify the full file path.

You can specify this property either as a nested vector of file names, or as a carriage-return delimited simple character vector, or as a character matrix with one name per row (trailing blanks are stripped off). When you read the property, APLX always returns the nested vector form.