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

LeftA coordenada horizontal da margem esquerda do retângulo da área sensível
TopA coordenada vertical da margem superior do retângulo da zona ativa
WidthA largura do retângulo da área sensível
HeightA altura do retângulo da área sensível
URLO URL de destino do envio armazenado na especificação de ficheiro da ação
FieldNamesLista 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
FlagsIndicadores 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
OptionsMá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

0A ação não foi adicionada porque o documento está no modo PDF/A, o retângulo é inválido ou URL está vazio
1A 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