КоллекцияСтраницPDF.Индекс

Методы · IndexOf

Получает индекс элемента коллекции.

Синтаксис

Индекс(<Элемент>)
Полное описание, параметры и ограничения

КоллекцияСтраницPDF.Индекс (PDFPagesCollection.IndexOf)

КоллекцияСтраницPDF (PDFPagesCollection)

Индекс (IndexOf)

Доступен, начиная с версии 8.3.26.

Синтаксис:
Индекс(<Элемент>)
Параметры:

<Элемент> (необязательный)
Тип: СтраницаPDF.
Элемент, индекс которого требуется получить.
Возвращаемое значение:
Тип: Число.
Индекс указанного элемента коллекции. Если такого элемента нет, возвращается -1.
Описание:

Получает индекс элемента коллекции.

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

Тонкий клиент, веб-клиент, сервер, толстый клиент.

Использование в версии:

Доступен, начиная с версии 8.3.26.

Методическая информация

Практические примеры

Создать настоящий учебный PDF и разобрать страницу

Экспортируем таблицу Книга / 3 / 250 / 750 и читаем PDF обратно. Индекс коллекции начинается с нуля, номер страницы — с единицы.

Где и как запускать

Полный серверный общий модуль УчебныйPDF собственной учебной конфигурации; только собственные PDF-байты в памяти.

Подготовка

  1. Отдельная собственная учебная база 8.5.1.1343: серверный общий модуль УчебныйPDF. Вставьте полный модуль одного урока и вызовите ВыполнитьПример() своей серверной командой.

  2. Имя конфигурации должно быть УчебнаяКонфигурацияСинтаксиса. Все данные создаются кодом: строка Книга / 3 / 250 / 750 и собственные текстовые вложения.

  3. Исходный PDF получается настоящим экспортом собственного ТабличныйДокумент в ПотокВПамяти. Никакого файла с неизвестным происхождением или рабочего печатного макета не требуется.

  4. Чтение и повторная запись выполняются в памяти. Примеры не печатают, не обращаются к интернету и не меняют документы базы.

  5. Проверки размеров, страниц и вложений не доказывают вид штампа или оттенки серого. Для визуального контроля используйте отдельный урок просмотра собственного PDF; этот серверный модуль окна не открывает.

Функция СоздатьСобственныеБайтыPDF()
    Таблица = Новый ТабличныйДокумент;
    Таблица.КодЯзыка = "ru";
    Таблица.Область(1, 1).Текст = "СОБСТВЕННЫЙ УЧЕБНЫЙ ОБРАЗЕЦ";
    Таблица.Область(2, 1).Текст = "Книга";
    Таблица.Область(2, 2).Текст = "3";
    Таблица.Область(2, 3).Текст = "250";
    Таблица.Область(2, 4).Текст = "750";
    Таблица.Область(1, 1, 2, 4).ЦветФона = Новый Цвет(255, 255, 210);
    Таблица.Область(, 1, , 1).ШиринаКолонки = 45;
    Поток = Новый ПотокВПамяти;
    Попытка
        Таблица.Записать(Поток, ТипФайлаТабличногоДокумента.PDF);
        Данные = Поток.ЗакрытьИПолучитьДвоичныеДанные();
    Исключение
        Поток.Закрыть();
        ВызватьИсключение;
    КонецПопытки;
    Возврат Данные;
КонецФункции

Функция ПрочитатьСобственныйДокумент(Данные)
    Поток = Данные.ОткрытьПотокДляЧтения();
    Попытка
        Документ = Новый ДокументPDF;
        Документ.Прочитать(Поток);
        Поток.Закрыть();
    Исключение
        Поток.Закрыть();
        ВызватьИсключение;
    КонецПопытки;
    Возврат Документ;
КонецФункции

Процедура ВыполнитьПример() Экспорт
    Данные = СоздатьСобственныеБайтыPDF();
    Документ = ПрочитатьСобственныйДокумент(Данные);
    Страницы = Документ.Страницы;
    Сообщить(Данные.Размер() > 0);
    Сообщить(Страницы.Количество() = Документ.КоличествоСтраниц());
    Если Страницы.Количество() = 0 Тогда
        ВызватьИсключение "В собственном PDF нет страниц";
    КонецЕсли;
    Первая = Страницы.Получить(0);
    Сообщить(Первая.Номер = 1);
    Сообщить(Страницы.Индекс(Первая) = 0);
    Сообщить(Первая.Ширина > 0 И Первая.Высота > 0);
    Сообщить(ТипЗнч(Первая.Ориентация) = Тип("Число"));
    Сообщить(Первая.ПолеСверху >= 0 И Первая.ПолеСнизу >= 0);
    Сообщить(Первая.ПолеСлева >= 0 И Первая.ПолеСправа >= 0);
    Сообщить("Размер страницы, мм: " + Строка(Первая.Ширина) + " × " + Строка(Первая.Высота));
    Сообщить("Угол, градусы: " + Строка(Первая.Ориентация));
    Сообщить("Формат PDF: " + Строка(Документ.ТипФайла));
    Сообщить(Документ.Вложения.Количество() = 0);
КонецПроцедуры

Разбор по шагам

  1. Создать табличный документ и экспортировать в поток. Получить ДвоичныеДанные вместе с закрытием исходного потока.

  2. Открыть отдельный поток чтения, прочитать ДокументPDF и закрыть поток. Сам документ продолжает хранить прочитанные данные.

  3. Сверить количество страниц двумя настоящими API. Проверить наличие хотя бы одной страницы перед Получить(0).

  4. Прочитать номер, размеры, угол и четыре поля. Все свойства страницы только для чтения; мм и градусы — разные единицы.

Как проверить результат

  1. Девять булевых проверок должны дать Истина. Получить(0).Номер = 1 и Индекс(Первая) = 0.

  2. Выводятся реальные размеры и угол собственной страницы, а не зашитое предположение A4. Вложений исходного документа нет.

Ожидаемый результат

Полный путь от собственной таблицы к настоящему PDF и читаемому паспорту страницы.

На что обратить внимание

  1. Количество страниц зависит от вывода таблицы, размеров и настроек; не переносите ожидание одной страницы на произвольный отчёт.

  2. Ориентация страницы PDF — числовой угол, а не перечисление Портрет/Альбом и не Булево.

  3. СтраницаPDF не имеет конструктора и изменяемых размеров. Коллекция страниц не имеет Добавить, Удалить или Очистить.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.