Получает индекс рисунка в коллекции.
Синтаксис
Индекс(<Рисунок>)Полное описание, параметры и ограничения
КоллекцияРисунковТабличногоДокумента.Индекс (SpreadsheetDocumentDrawingCollection.IndexOf)
КоллекцияРисунковТабличногоДокумента (SpreadsheetDocumentDrawingCollection)
Индекс (IndexOf)
Доступен, начиная с версии 8.0.
Синтаксис:
Индекс(<Рисунок>)
Параметры:
<Рисунок> (обязательный)
Тип: РисунокТабличногоДокумента.
Рисунок табличного документа, индекс которого нужно определить.
Возвращаемое значение:
Тип: Число.
Индекс указанного рисунка в коллекции. Если не найдено, то возвращается -1.
Описание:
Получает индекс рисунка в коллекции.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Удалить собственные черновые рисунки и оставить полезную подпись
Коллекция рисунков поддерживает получение, индекс и удаление по объекту. Очистить применяем только к отдельному черновому документу, не к рабочему макету.
Где и как запускать
Полный модуль управляемой формы собственной учебной внешней обработки. Построение выполняется на сервере без контекста; показ — на клиенте. Вставляйте на уровне модуля.
Подготовка
Создайте новую внешнюю обработку с управляемой основной формой в учебной базе. Каждый урок — отдельная копия модуля.
На форме создайте команду УчебныйПример и перетащите её на форму как кнопку. В действии команды выберите процедуру УчебныйПример(Команда).
Вставьте весь модуль из примера: УчебныйПример, ПостроитьУчебныйДокумент и УчебнаяТаблица. Серверный вызов возвращает собственный табличный документ клиенту; директивы не удаляйте.
Никакие макеты, документы и справочники конфигурации не нужны. Всё построение — в памяти, без печати, записи файлов и отправки в сервисы.
Показ и ручную проверку выполняйте в тонком клиенте Windows 8.5.1.1343. Каждый урок — отдельная копия формы с пустым модулем до вставки.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = ПостроитьУчебныйДокумент();
ТабДок.Показать("Учебный документ — без печати и сохранения");
КонецПроцедуры
&НаСервереБезКонтекста
Функция ПостроитьУчебныйДокумент()
ТабДок = Новый ТабличныйДокумент;
Черновик = Новый ТабличныйДокумент;
Прямоугольник = Черновик.Рисунки.Добавить(ТипРисункаТабличногоДокумента.Прямоугольник);
Прямоугольник.Имя = "ЧерноваяРамка";
Эллипс = Черновик.Рисунки.Добавить(ТипРисункаТабличногоДокумента.Эллипс);
Эллипс.Имя = "ЧерновойКруг";
Сообщить(Черновик.Рисунки.Количество() = 2);
ИндексКруга = Черновик.Рисунки.Индекс(Эллипс);
Сообщить(Черновик.Рисунки.Получить(ИндексКруга).Имя = "ЧерновойКруг");
Черновик.Рисунки.Удалить(Прямоугольник);
Сообщить(Черновик.Рисунки.Количество() = 1);
Черновик.Рисунки.Очистить();
Сообщить(Черновик.Рисунки.Количество() = 0);
Надпись = ТабДок.Рисунки.Добавить(ТипРисункаТабличногоДокумента.Текст);
Надпись.Имя = "ПолезнаяПодпись";
Надпись.Лево = 5;
Надпись.Верх = 5;
Надпись.Ширина = 80;
Надпись.Высота = 15;
Надпись.Текст = "Подпись только для экрана";
Надпись.ВыводитьНаПечать = Ложь;
ТабДок.ТолькоПросмотр = Истина;
Сообщить(ТабДок.Рисунки.Количество() = 1);
Сообщить(Не Надпись.ВыводитьНаПечать);
Возврат ТабДок;
КонецФункции
Разбор по шагам
Две черновые фигуры создаются в отдельном новом документе Черновик. Их можно удалять без ущерба для возвращаемого ТабДок.
Индекс ищет позицию объекта; Получить читает по индексу с 0. Удалить принимает сам объект рисунка, не обязательно число.
Очистить удаляет все рисунки черновика. Возвращаемый документ содержит другую полезную надпись.
ВыводитьНаПечать = Ложь оставляет надпись для экрана и исключает из возможной печати. В упражнении принтер не вызывается.
Как проверить результат
Шесть проверок дают Истина.
В показе остаётся только Подпись только для экрана. Черновые фигуры не передаются клиенту.
Ожидаемый результат
Полный цикл собственной коллекции без удаления элементов чужого макета.
На что обратить внимание
Очистить у рисунков не очищает содержимое ячеек, но удалит все рисунки данного документа.
Имена рисунков не заменяют устойчивую проверку наличия объекта; здесь все экземпляры созданы перед использованием.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.