TextPage Свойство

TextPage предоставляет необработанный дескриптор FPDF_TEXTPAGE PDFium, связанный с текущей загруженной страницей. Дескриптор создаётся лениво, когда страница становится активной, и поддерживается в течение времени жизни этой привязки страницы; он даёт прямой доступ к API извлечения текста PDFium (FPDFText_*) для вызывающих, которым нужны операции, не предоставляемые свойствами TPdf более высокого уровня — например, текстовые прогоны на уровне глифов, данные кёрнинга, пользовательская семантика поиска или прямые сопоставления индекс символ — ограничивающий прямоугольник

Дескриптор действителен только пока Active равно True и выбрана допустимая страница. Переключение страниц (присвоение нового PageNumber или вызов ReloadPage) уничтожает предыдущий дескриптор и создаёт новый, поэтому не храните дескриптор между сменами страниц. Компонент владеет дескриптором и освободит его при демонтаже страницы — не вызывайте FPDFText_ClosePage для него самостоятельно

Это расширенное свойство. Большинству вызывающих следует предпочесть обёртки высокого уровня CharacterCount, Character[I], CharacterRectangle[I], Find / FindNext — они уже управляют жизненным циклом FPDF_TEXTPAGE внутренне. Опускайтесь до необработанного дескриптора только тогда, когда нужны API PDFium, которые PDFium Delphi Component ещё не предоставил

• Возвращает nil, когда ни одна страница не активна. Всегда проверяйте дескриптор перед передачей его в PDFium
• Дескриптор отражает поток содержимого страницы в том виде, в каком он разобран PDFium — он не включает состояние извлечения из FPDFText_FindStart; этот контекст поиска принадлежит независимо через свойство Find
• Вызов необработанных API PDFium через этот дескриптор обходит слои кэширования PDFium Delphi Component, поэтому интенсивное использование может ухудшить производительность по сравнению с методами доступа высокого уровня