GetSelectedFormText Metodo

Restituisce il testo attualmente selezionato nel widget AcroForm con focus sulla pagina attiva della vista

GetSelectedFormText è un punto di ingresso di alto livello basato sul binding FORM_GetSelectedText di PDFium. L'API di PDFium era già vincolata a livello di unit ma non aveva un accessor pratico per Pascal fino a v1.23.0; questo metodo la incapsula in modo pulito

Il metodo fa riferimento al widget AcroForm che attualmente detiene il focus sulla pagina attiva della vista (lo stesso widget che risponde all'input da tastiera). Quando l'utente ha selezionato un intervallo di caratteri all'interno di quel widget — per esempio con Shift+Freccia o con clic e trascinamento — GetSelectedFormText restituisce il testo della selezione come WString. Quando nessun testo è selezionato (solo una posizione del caret), GetSelectedFormText restituisce una stringa vuota

Il metodo è un no-op quando:

• la vista è inattiva (Active = False);
• il documento non contiene un AcroForm (FormType = ftNone);
• oppure nessun widget ha il focus sulla pagina corrente

In tutti e tre i casi il valore restituito è una stringa vuota — il metodo non solleva mai eccezioni

• Abbinare SelectAllFormText per selezionare il valore completo del widget, quindi chiamare CopySelectedFormTextToClipboard per una gestione difensiva Unicode degli appunti
• La selezione è locale al widget — selezionare testo di pagina fuori da qualsiasi widget non viene restituito da GetSelectedFormText; per quello usare le API di estrazione del testo a livello di carattere
• Lo stato di selezione è gestito dal modulo di compilazione dei moduli di PDFium; assegnare un nuovo valore tramite FormField[i] := ... può ridurre la selezione a un semplice caret

CopySelectedFormTextToClipboard, SelectAllFormText, FormUndo, FormRedo, FormField