Lotus Domino Designer 8.5 Help - EditDocument method

LOTUSSCRIPT/COM/OLE CLASSES

EditDocument method
Example

Opens the current or a specified document in a mode that you specify.

Defined in

Syntax

Set notesUIDocument = notesUIWorkspace.EditDocument( [editMode] , [notesDocument] , [notesDocumentReadOnly] , [documentAnchor$] , [returnNotesUIDocument] , [newInstance] )

Parameters

editMode

Boolean. Optional. Specify True (default) to open the document in Edit mode. Specify False to open the document in Read mode or to put the document in the given Edit mode.

notesDocument

NotesDocument. Optional. Opens the specified document instead of the currently selected document.

notesDocumentReadOnly

Boolean. Optional. If True, sets

notesDocument

to read-only mode, which prevents the user from later switching to read-write mode. Defaults to False. This parameter does not open the document in Read mode; you must set

editMode

to False. This parameter has no effect if you do not specify

notesDocument

documentAnchor$

String. Optional. Opens the document to an anchor link within the document. This parameter specifies the text of the anchor link. The edit mode (parameter 1) must be False if this parameter is specified.

returnNotesUIDocument

Boolean. Optional. If True (default), attempts to return the NotesUIDocument object; if False, does not attempt to return the object. See the usage note on lsERR_LSXU13_ANCESTOR_TARGET_FRAME.

Note This parameter is new with Release 5.0.6.

newInstance

Boolean. Optional. If True (default), opens a new instance of

notesDocument

(parameter 2) in the UI. If False, changes focus to an existing instance of

notesDocument

if one exists, or to a new instance if one does not exist. This parameter does not apply if

notesDocument

is not specified or the document has a target frame.

Note This parameter is new with Release 6.

Return value

notesUIDocument

The document that's just been opened. Does not attempt to return this object if

returnNotesUIDocument

is False.

Usage

The current document may be either of the following:

The document that's currently open.
The document that's currently selected in a view or folder.

This method raises the error lsERR_LSXU13_ANCESTOR_TARGET_FRAME (4426) if it attempts to return a NotesUIDocument object for a target frame that is the ancestor of the frame containing the code. You can suppress returning the object by specifying returnNotesUIDocument as False. The document opens in the target frame but you do not have access to its NotesUIDocument object. Calling this method as a subroutine does not suppress returning the object; you must specify returnNotesUIDocument as False.

Language cross-reference

EditDocument @command in formula language

OpenDocument @command in formula language

Example
See Also

Accessing the current document in LotusScript classes

Glossary

Feedback on Help or Product Usability?

Help on Help

All Help Contents

Glossary