AddLinkToResetFormA
Anotações e links de hotspot, Campos de formulário e AcroForms
Descrição
O sufixo A 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 AddLinkToResetForm e os argumentos de string são interpretados usando a página de código atual definida por SetAnsiMode
Adiciona um retângulo de hotspot clicável à página selecionada que aciona uma ação de redefinição de formulário PDF quando ativado. Uma ação de redefinição de formulário 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 que o visualizador redefina todos os campos aplicáveis
Use a função SetAnnotBorderColor para alterar a cor da borda do hotspot
Sintaxe
Delphi
Function DLAddLinkToResetFormA(InstanceID: Integer; Left, Top, Width, Height: Double; FieldNames: PAnsiChar; Flags, Options: Integer): Integer;DLL
int DLAddLinkToResetFormA(int InstanceID, double Left, double Top, double Width, double Height, const char * FieldNames, int Flags, int Options);Parâmetros
| Left | A coordenada horizontal da borda esquerda do retângulo de hotspot |
|---|---|
| Top | A coordenada vertical da borda superior do retângulo de hotspot |
| Width | A largura do retângulo de hotspot |
| Height | A altura do retângulo de 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 no início e no final de cada nome são removidos |
| Flags | Sinalizadores da ação de redefinição de formulário PDF gravados na entrada /Flags da ação. Passe 0 para o comportamento padrão. Os visualizadores padrão usam os bits de flag 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 de hotspot. Os bits 1-3 selecionam o modo de destaque ao clicar (2 = Inverter, 4 = Contorno, 8 = Pressionar); quando nenhum bit de destaque é definido, Inverter é usado como padrão |
Valores retornados
| 0 | A ação não foi adicionada porque o documento está no modo PDF/A ou o retângulo é inválido |
|---|---|
| 1 | A anotação de link e a ação de redefinição de formulário foram adicionadas |
Observações
O modo PDF/A bloqueia esta ação porque ações de formulários interativos não são adequadas para conformidade de arquivamento. A função requer PDF 1.2 ou posterior