GetSelectedFormText метод

GetSelectedFormText — це точка входу високого рівня над прив'язкою FORM_GetSelectedText з PDFium. API PDFium уже було прив'язане на рівні модуля, але до v1.23.0 не мало дружнього до Pascal засобу доступу; цей метод охайно огортає його.

Метод націлений на той віджет AcroForm, який зараз володіє фокусом на активній сторінці подання (той самий віджет, що відповідає на введення з клавіатури). Коли користувач виділив діапазон символів усередині цього віджета — наприклад Shift+стрілка чи клацання з перетягуванням — GetSelectedFormText повертає текст виділення як WString. Коли текст не виділено (лише позиція каретки), GetSelectedFormText повертає порожній рядок.

Метод нічого не робить, коли:

• подання неактивне (Active = False);
• документ не містить AcroForm (FormType = ftNone);
• або на поточній сторінці не сфокусовано жодного віджета.

У всіх трьох випадках повернене значення — порожній рядок — метод ніколи не викликає винятку.

• Поєднуйте з SelectAllFormText, щоб виділити повне значення віджета, а потім викличте CopySelectedFormTextToClipboard для оборонної роботи з буфером обміну Unicode
• Виділення є локальним для віджета — виділення тексту сторінки поза будь-яким віджетом не повертається через GetSelectedFormText; для цього використовуйте API видобування тексту на рівні символів.
• Стан виділення керується модулем заповнення форм PDFium; призначення нового значення через FormField[i] := ... може згорнути виділення назад до каретки.