AddLinkToResetForm
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 reposição de formulário PDF quando activado. Uma acção de reposição de formulário restaura os campos AcroForm para os seus valores predefinidos sem recorrer a JavaScript
Utilize FieldNames para restringir os campos afectados pela acção de reposição. Deixe FieldNames vazio para permitir que o visualizador reponha todos os campos aplicáveis
Utilize a função SetAnnotBorderColor para alterar a cor do contorno do hotspot
Sintaxe
Delphi
Function TPDFlib.AddLinkToResetForm(Left, Top, Width, Height: Double; Const FieldNames: WideString; Flags, Options: Integer): Integer;DLL
int DLAddLinkToResetForm(int InstanceID, double Left, double Top, double Width, double Height, 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 |
| 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 reposição de formulário PDF escritos na entrada /Flags da acção. Passe 0 para o comportamento predefinido. Os visualizadores padrão utilizam os bits de sinalizador em conjunto com /Fields para determinar se a lista é inclusiva ou exclusiva |
| 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 ou o rectângulo é inválido |
|---|---|
| 1 | A anotação de ligação e a acção de reposição de formulário foram adicionadas |
Observações
O modo PDF/A bloqueia esta acção porque as acções interactivas em formulários não são adequadas para conformidade de arquivo. A função requer PDF 1.2 ou posterior