GetSelectedFormText Método

Devuelve el texto actualmente seleccionado dentro del widget de AcroForm enfocado en la página activa de la vista

GetSelectedFormText es un punto de entrada de alto nivel sobre el enlace FORM_GetSelectedText de PDFium. La API de PDFium ya estaba enlazada a nivel de unidad pero no tenía un accesor amigable para Pascal hasta v1.23.0; este método la envuelve de forma limpia

El método se dirige al widget de AcroForm que actualmente posee el foco en la página activa de la vista (el mismo widget que responde a la entrada de teclado). Cuando el usuario ha seleccionado un intervalo de caracteres dentro de ese widget — por ejemplo con Mayús+Flecha o haciendo clic y arrastrando — GetSelectedFormText devuelve el texto de la selección como WString. Cuando no hay texto seleccionado (solo una posición de cursor), GetSelectedFormText devuelve una cadena vacía

El método no hace nada cuando:

• la vista está inactiva (Active = False);
• el documento no lleva AcroForm (FormType = ftNone);
• o no hay ningún widget enfocado en la página actual

En los tres casos el valor devuelto es una cadena vacía — el método nunca lanza excepciones

• Combínelo con SelectAllFormText para seleccionar el valor completo del widget y luego llame a CopySelectedFormTextToClipboard para un manejo defensivo del portapapeles Unicode
• La selección es local al widget — seleccionar texto de la página fuera de cualquier widget no se devuelve a través de GetSelectedFormText; para eso use las API de extracción de texto a nivel de carácter
• El estado de la selección lo gestiona el módulo de relleno de formularios de PDFium; asignar un nuevo valor mediante FormField[i] := ... puede contraer la selección de vuelta a un cursor

CopySelectedFormTextToClipboard, SelectAllFormText, FormUndo, FormRedo, FormField