Appends a text value into a field in a document without removing the existing contents of the field.

Defined in

NotesUIDocument

Syntax

Call notesUIDocument.FieldAppendText( fieldName$, text$ )

Parameters

fieldName$

String. The field into which you want to append text$. The field must be editable. Specify an empty string ("") to append the text to the current field.

String. The value you want to append to the field.

This method is valid only when the document is in Edit mode.

If there is already some text in the field, the new text is added directly after the last character of the existing text.

Errors

If the fieldName$ does not exist on the document, this method returns the error "Cannot locate field definition for fieldName$."

If the document is not in Edit mode, this method returns the error "You must be in Edit mode to change the value of a field."

Example
See Also

CurrentField property
EditMode property
FieldClear method
FieldContains method
FieldGetText method
FieldSetText method

Glossary