AddLinkToSubmitForm
Anotações e links de hotspot, Campos de formulário e AcroForms
Descrição
Adiciona um retângulo de hotspot clicável à página selecionada que aciona uma ação de envio de formulário PDF quando ativado. Uma ação de envio de formulário envia os valores dos campos AcroForm para uma URL ou endpoint de processamento de formulário sem exigir JavaScript
Use FieldNames para restringir os campos enviados. Deixe FieldNames vazio para que o visualizador envie todos os campos aplicáveis
Use a função SetAnnotBorderColor para alterar a cor da borda do hotspot
Sintaxe
Delphi
Function TPDFlib.AddLinkToSubmitForm(Left, Top, Width, Height: Double; Const URL, FieldNames: WideString; Flags, Options: Integer): Integer;DLL
int DLAddLinkToSubmitForm(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * URL, const wchar_t * FieldNames, int Flags, int Options);Parâmetros
| Left | A coordenada horizontal da borda esquerda do retângulo de hotspot |
|---|---|
| Top | A coordenada vertical da borda superior do retângulo de hotspot |
| Width | A largura do retângulo de hotspot |
| Height | A altura do retângulo de hotspot |
| URL | A URL de destino do envio armazenada na especificação de arquivo da ação |
| FieldNames | Lista opcional de nomes de campos AcroForm completamente qualificados separados por vírgulas, ponto e vírgula ou quebras de linha. Os espaços em branco no início e no final de cada nome são removidos |
| Flags | Sinalizadores da ação de envio de formulário PDF gravados na entrada /Flags da ação. Passe 0 para o envio padrão no estilo FDF. Os bits padrão mais comuns incluem 4 para formato HTML, 32 para XFDF e 256 para enviar o documento PDF completo |
| Options | Máscara de bits que controla a aparência do link. Bit 0 (valor 1): desenha uma borda ao redor do retângulo de hotspot. Os bits 1-3 selecionam o modo de destaque ao clicar (2 = Inverter, 4 = Contorno, 8 = Pressionar); quando nenhum bit de destaque é definido, Inverter é usado como padrão |
Valor de retorno
| 0 | A ação não foi adicionada porque o documento está no modo PDF/A, o retângulo é inválido ou URL está vazio |
|---|---|
| 1 | A anotação de link e a ação de envio de formulário foram adicionadas |
Observações
O modo PDF/A bloqueia esta ação porque ela pode referenciar um destino de envio externo. A função requer PDF 1.2 ou posterior