FormattedDocument.Insert

Syntax:

Insert(<Bookmark>, <Value>, <ElementType>)

Parameters:

<Bookmark> (required)

Type: FormattedDocumentBookmark.
Defines a position where the formatted document element must be inserted.

<Value> (optional)

Type: Arbitrary.
Contains the value which is inserted in formatted document.
Depending on <ElementType> parameter value of the current method, the value can be read in various ways.
If parameter value is FormattedDocumentText, then string presentation of transferred value will be inserted in specified document position.
If the value is FormattedDocumentPicture, then value type should be either Picture, or String, containing URL of the picture. Otherwise, the exception is called. The image will be inserted to the specified location.
If parameter value is FormattedDocumentLinefeed, then parameter value is ignored and string transfer is inserted to the specified location.
Default value: Undefined.

<ElementType> (optional)

Type: Type.
Specifies the type of element to be inserted. Depending on the value of this parameter the <Value> parameter value of this method is interpreted.
A collection can contain the following objects:
1) FormattedDocumentText
2) FormattedDocumentPicture
3) FormattedDocumentLinefeed
. Depending on the value of this parameter the <Value> parameter value of this method is interpreted.
Default value: FormattedDocumentText.

Returned value:

Type: FormattedDocumentText; FormattedDocumentLinefeed; FormattedDocumentPicture.
Returns item, inserted into the formatted document.

Description:

Inserts a line, picture or line feed into specified position of formatted document.

Availability:

Thin client, web-client, server, thick client, external connection.

Note:

Inserting pictures is only available at the server.
Picture must be absolute.

    

1C:Enterprise Developer's Community