AddLinkToSubmitForm
Annotations and hotspot links, Form fields and AcroForms
Descrição
Adiciona um rectângulo hotspot clicável à página seleccionada que aciona uma acção de envio de formulário PDF quando activado. Uma acção de envio de formulário envia os valores dos campos AcroForm para um URL ou ponto final de processamento de formulários sem recorrer a 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 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 margem esquerda do rectângulo hotspot |
|---|---|
| Top | A coordenada vertical da margem superior do rectângulo hotspot |
| Width | A largura do rectângulo hotspot |
| Height | A altura do rectângulo hotspot |
| URL | O URL de destino do envio guardado na especificação de ficheiro da acçã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 iniciais e finais em torno de cada nome são removidos |
| Flags | Sinalizadores da acção de envio de formulário PDF escritos na entrada /Flags da acção. Passe 0 para o envio predefinido em estilo FDF. Os bits padrão comuns incluem 4 para formato HTML, 32 para XFDF e 256 para enviar o documento PDF completo |
| Options | Máscara de bits que controla o aspecto da ligação. Bit 0 (valor 1): desenha um contorno em torno do rectângulo hotspot. Os bits 1-3 seleccionam o modo de realce ao clicar (2 = Inverter, 4 = Contorno, 8 = Premir); quando nenhum bit de realce está definido, Inverter é utilizado como predefinição |
Valores de retorno
| 0 | A acção não foi adicionada porque o documento está em modo PDF/A, o rectângulo é inválido ou URL está vazio |
|---|---|
| 1 | A anotação de ligação e a acção de envio de formulário foram adicionadas |
Observações
O modo PDF/A bloqueia esta acção porque pode referenciar um destino de envio externo. A função requer PDF 1.2 ou posterior