Phương thức GetSelectedFormText

GetSelectedFormText là điểm vào cấp cao dựng trên liên kết FORM_GetSelectedText của PDFium. API PDFium vốn đã được liên kết ở cấp unit nhưng chưa có bộ truy cập thân thiện Pascal cho đến v1.23.0; phương thức này bọc nó một cách gọn gàng.

Phương thức nhắm vào widget AcroForm bất kỳ đang sở hữu focus trên trang hiệu lực của khung xem (cùng widget đó đáp ứng bàn phím). Khi người dùng đã chọn một khoảng ký tự bên trong widget đó — ví dụ bằng Shift+Mũi tên hoặc nhấp và kéo — GetSelectedFormText trả về văn bản lựa chọn dưới dạng WString. Khi không có văn bản nào được chọn (chỉ có vị trí con trỏ), GetSelectedFormText trả về chuỗi rỗng.

Phương thức là no-op khi:

• khung xem không hiệu lực (Active = False);
• tài liệu không mang AcroForm (FormType = ftNone);
• hoặc không widget nào được focus trên trang hiện tại.

Trong cả ba trường hợp giá trị trả về là chuỗi rỗng — phương thức không bao giờ phát sinh ngoại lệ.

• Ghép với SelectAllFormText để chọn toàn bộ giá trị widget, sau đó gọi CopySelectedFormTextToClipboard để xử lý clipboard Unicode phòng thủ
• Lựa chọn là cục bộ theo widget — việc chọn văn bản trang ngoài mọi widget không trả về qua GetSelectedFormText; với trường hợp đó hãy dùng các API trích xuất văn bản cấp ký tự.
• Trạng thái lựa chọn do module form-fill của PDFium quản lý; việc gán giá trị mới qua FormField[i] := ... có thể thu gọn lựa chọn trở lại thành con trỏ.