GetObjectByPath

Свойства документа, извлечение содержимого

Описание

Читает любой узел дерева объектов через выражение пути, без обхода объектов по номерам

Синтаксис

Delphi

Function TPDFlib.GetObjectByPath(Const Path: WideString; InfoID: Integer): WideString;

Параметры

Path	The path expression.
InfoID	`1` имя типа (`boolean`, `number`, `string`, `name`, `array`, `dict`, `stream`, `null`); `2` скалярное значение как текст; `3` сериализованная форма, не более 64 КБ; `4` имя ключа, если последний шаг выбрал запись словаря по индексу

Возвращаемые значения

''	Путь не разрешается либо значение не имеет представления для запрошенного InfoID
Text	Запрошенные сведения

Примечания

Шаги пути — ключи словарей, разделенные /, начиная с trailer (Root/Pages/Kids[0]/MediaBox), с необязательным префиксом trailer и корнем pages[N], выбирающим N-й словарь страницы (отсчет от нуля). Селектор [N] с отсчетом от нуля выбирает элемент массива или N-ю запись словаря, а косвенные ссылки разрешаются на каждом шаге

Один вызов закрывает зондирование метаданных, точечные проверки соответствия и диагностические запросы поддержки, которые раньше требовали GetObjectToString плюс ручной разбор

Пример

W:= PDF.GetObjectByPath('Root/Pages/Kids[0]/MediaBox[2]', 2); // page width
T:= PDF.GetObjectByPath('pages[0]/Type', 2);                 // 'Page'

См. также

GetObjectByPathCount, GetObjectToString, GetCatalogInformation