AddLinkToResetForm
Anotações e links de zona ativa, Campos de formulário e AcroForms
Descrição
Adiciona um retângulo de ponto ativo clicável à página selecionada que dispara uma ação reset-form do PDF quando ativado. Uma ação reset-form restaura os campos AcroForm para seus valores padrão sem exigir JavaScript Use
FieldNames para restringir os campos afetados pela ação de redefinição. Deixe FieldNames vazio para permitir que o visualizador redefina todos os campos aplicáveis
Use a função
SetAnnotBorderColor para alterar a cor da borda do ponto ativo
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 borda esquerda do retângulo do ponto ativo |
|---|---|
| Top | A coordenada vertical da borda superior do retângulo do ponto ativo |
| Width | A largura do retângulo do ponto ativo |
| Height | A altura do retângulo do ponto ativo |
| FieldNames | Lista opcional de nomes de campos AcroForm totalmente qualificados separados por vírgulas, ponto e vírgula ou quebras de linha. Espaços em branco à esquerda e à direita ao redor de cada nome são removidos |
| Flags | Sinalizadores da ação reset-form do PDF gravados na entrada /Flags da ação. Passe 0 para o comportamento padrão. Visualizadores padrão usam os bits de sinalizador junto com /Fields para decidir se a lista é inclusiva ou exclusiva |
| Options | Máscara de bits que controla a aparência do link. Bit 0 (valor 1): desenha uma borda ao redor do retângulo do ponto ativo. Os bits 1-3 selecionam o modo de realce no clique (2 = Invert, 4 = Outline, 8 = Push); quando nenhum bit de realce está definido, Invert é usado como padrão |
Valores retornados
| 0 | A ação não foi adicionada porque o documento está em modo PDF/A ou PDF/X-6, ou o retângulo é inválido |
|---|---|
| 1 | A anotação de link e a ação reset-form foram adicionadas |
Observações
Os modos PDF/A e PDF/X-6 bloqueiam esta ação; a função requer PDF 1.2 ou posterior