Вставить

[1cwiki]

Раздел

Общие объекты

Подразделы

Форматированный документ

ТипСтатьи

Методы

Синтаксис:

Вставить(<Индекс>, <Значение>, <ТипЭлемента>)
Параметры:

<Индекс> (обязательный)

Тип: Число.
Позиция, в которую необходимо вставить элемент форматированного документа.
<Значение> (необязательный)

Тип: Произвольный.
Элемент, вставляемый в коллекцию.
В зависимости от параметра <ТипЭлемента> данного метода значение интерпретируется по-разному.
Если значение параметра ТекстФорматированногоДокумента, то в коллекцию будет вставлено строковое представление переданного значения.
Если значение параметра КартинкаФорматированногоДокумента, то тип параметра <Значение> должен быть или Картинка, или Строка, содержащая URL картинки. В противном случае вызывается исключение.
Если значение параметра ПереводСтрокиФорматированногоДокумента, то значение параметра игнорируется и в коллекцию вставляется перевод строки.
Если значение параметров Неопределено, а также коллекция элементов форматированного документа содержит только параграфы, то в коллекцию вставляется пустой параграф.
Значение по умолчанию: Неопределено.
<ТипЭлемента> (необязательный)

Тип: Тип.
Тип элемента, который нужно вставить в коллекцию. В зависимости от значения этого параметра интерпретируется значение параметра <Значение> данного метода.
Элементами коллекции могут быть:
1) ТекстФорматированногоДокумента
2) КартинкаФорматированногоДокумента
3) ПереводСтрокиФорматированногоДокумента
В зависимости от значения этого параметра интерпретируется значение параметра <Значение> данного метода.
Значение по умолчанию: ТекстФорматированногоДокумента.
Возвращаемое значение:

Тип: ПараграфФорматированногоДокумента; ТекстФорматированногоДокумента; ПереводСтрокиФорматированногоДокумента; КартинкаФорматированногоДокумента.
Возвращает вставленный элемент.
Описание:

Вставляет элемент в указанную позицию в форматированный документ.

Доступность:

Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение.
Примечание:

Вставка картинки доступна только на сервере.
Картинка должна быть абсолютной.