GetSelectedFormText Método

GetSelectedFormText é um ponto de entrada de alto nível sobre a vinculação FORM_GetSelectedText do PDFium. A API do PDFium já estava vinculada no nível da unidade, mas não tinha um acessador amigável ao Pascal até a v1.23.0; este método a envolve de forma limpa

O método tem como alvo o widget do AcroForm que atualmente possui o foco na página ativa da visualização (o mesmo widget que responde à entrada do teclado). Quando o usuário selecionou um intervalo de caracteres dentro desse widget — por exemplo com Shift+Arrow ou clique e arraste — GetSelectedFormText retorna o texto selecionado como um WString. Quando nenhum texto está selecionado (apenas uma posição de cursor), GetSelectedFormText retorna uma string vazia

O método não faz nada quando:

• a visualização está inativa (Active = False);
• o documento não contém AcroForm (FormType = ftNone);
• ou nenhum widget está em foco na página atual

Em todos os três casos o valor retornado é uma string vazia — o método nunca levanta exceção

• Combine com SelectAllFormText para dar suporte a um item de menu "Selecionar tudo", depois use GetSelectedFormText para alimentar a seleção em Clipboard.AsText
• A seleção é local ao widget — selecionar texto da página fora de qualquer widget não retorna por GetSelectedFormText; para isso use as APIs de extração de texto em nível de caractere
• O estado da seleção é gerenciado pelo módulo de preenchimento de formulários do PDFium; atribuir um novo valor por meio de FormField[i] := ... pode recolher a seleção de volta a um cursor