Attaches a file to a document.

Syntax

@Command( [EditInsertFileAttachment] )

or

@Command( [EditInsertFileAttachment] ; file ; compress ; append ; deleteexisting ; deletefile )

Parameters

file

Text. Optional. The name of the file you want to attach. Be sure to include the complete path specification (appropriate to the user's operating system).

Text. Optional. Specify "1" (default) if you want to compress the attachment. Specify "0" if you do not.

Text. Optional. Specify "1" if you want to append the attachment. Specify "0" (default) if you want to insert it at the current position.

deleteexisting

Text. Optional. Specify "1" if you want to delete the same existing attachment. Specify "0" (default) if you do not.

deletefile

Text. Optional. Specify "1" if you want to delete the base file. Specify "0" (default) if you do not.

Without a file parameter, displays the Create Attachment dialog box. If a file is specified, attaches that file to the document without opening the Create Attachment dialog box.

Usage

A document must be open in Edit mode with the insertion point in a rich text field.

This command does not work on the Web.

If using this command in a hotspot button or any other element that causes a change in focus, the EditGoToField or EditTop command must be used first to return the focus to the document. The document must be in Edit mode.

Language cross-reference

EmbedObject method of LotusScript NotesRichTextItem class

embedObject method of Java RichTextItem class

Example
See Also

@Commands with ECL security
@Commands

Glossary