AddLinkToResetFormA
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 AddLinkToResetForm 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 reposição de formulário quando é ativado. Uma ação de reposição de formulário restaura os valores predefinidos dos campos AcroForm sem exigir JavaScript
Utilize FieldNames para limitar os campos afetados pela açã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 da zona interativa
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 margem esquerda do retângulo da área sensível |
|---|---|
| Top | A coordenada vertical da margem superior do retângulo da zona ativa |
| Width | A largura do retângulo da área sensível |
| Height | A altura do retângulo da área sensível |
| FieldNames | Lista 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 |
| Flags | Indicadores de ação PDF de reposição de formulário escritos na entrada /Flags da ação. Passe 0 para o comportamento predefinido. Os visualizadores padrão utilizam os bits de indicadores juntamente com /Fields para decidir se a lista é inclusiva ou exclusiva |
| Options | Má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
| 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 ligação e a ação de reposição do formulário foram adicionadas |
Observações
O modo PDF/A bloqueia esta ação porque as ações interativas de formulários não são adequadas à conformidade de arquivo. A função exige PDF 1.2 ou posterior