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

LeftA coordenada horizontal da margem esquerda do retângulo da área sensível
TopA coordenada vertical da margem superior do retângulo da zona ativa
WidthA largura do retângulo da área sensível
HeightA altura do retângulo da área sensível
FieldNamesLista 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
FlagsIndicadores 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
OptionsMá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

0A ação não foi adicionada porque o documento está no modo PDF/A ou o retângulo é inválido
1A 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