AddLinkToSubmitForm
Anotações e ligações de zonas ativas, campos de formulário e AcroForms
Descrição
Adiciona à página selecionada um retângulo de área sensível clicável que aciona uma ação PDF de envio de formulário. A ação envia valores de campos AcroForm para um URL ou ponto final de processamento de formulários sem exigir JavaScript
Utilize FieldNames para restringir os campos enviados. Deixe FieldNames vazio para permitir que o visualizador envie todos os campos aplicáveis
Utilize a função SetAnnotBorderColor para alterar a cor do contorno da zona interativa
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 margem esquerda do retângulo da área sensível |
|---|---|
| Top | A coordenada vertical da margem superior do retângulo da zona ativa |
| Width | A largura do retângulo da área sensível |
| Height | A altura do retângulo da área sensível |
| URL | O URL de destino do envio armazenado na especificação de ficheiro da ação |
| FieldNames | Lista opcional de nomes de campos AcroForm totalmente qualificados, separados por vírgulas, pontos e vírgulas ou quebras de linha. Os espaços em branco no início e no fim de cada nome são removidos |
| Flags | Indicadores da ação PDF de envio de formulário escritos na entrada /Flags da ação. Passe 0 para o envio predefinido no estilo FDF. Os bits padrão comuns incluem 4 para o formato HTML, 32 para XFDF e 256 para enviar o documento PDF completo |
| Options | Máscara de bits que controla a apresentação da ligação. Bit 0 (valor 1): desenhar um contorno em torno do retângulo da zona ativa. Os bits 1-3 selecionam o modo de realce ao clicar (2 = Invert, 4 = Outline, 8 = Push); quando nenhum bit de realce estiver definido, Invert é utilizado como predefinição |
Valores devolvidos
| 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 ligação e a ação de envio de formulário foram adicionadas |
Observações
O modo PDF/A bloqueia esta ação porque pode referenciar um destino de envio externo. A função exige PDF 1.2 ou posterior