AddLinkToSubmitFormA
Anotações e ligações de zonas ativas, campos de formulário e AcroForms
Descrição
O A final indica o ponto de entrada ANSI (char) da DLL; a superfície ActiveX/COM expõe apenas a forma Unicode. O comportamento é idêntico ao de AddLinkToSubmitForm e os argumentos de cadeia são interpretados utilizando a página de códigos atual de SetAnsiMode
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 DLAddLinkToSubmitFormA(InstanceID: Integer; Left, Top, Width, Height: Double; URL, FieldNames: PAnsiChar; Flags, Options: Integer): Integer;
DLL
int DLAddLinkToSubmitFormA(int InstanceID, double Left, double Top, double Width, double Height, const char * URL, const char * 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