AddLinkToHideFieldA
Anotações e ligações de zonas ativas, 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 AddLinkToHideField e os argumentos de cadeia de caracteres são interpretados com base na página de código atual definida por SetAnsiMode
Adiciona à página selecionada um retângulo de área interativa clicável que aciona uma ação PDF Hide quando ativado. Uma ação Hide alterna a visibilidade de um ou mais campos AcroForm, permitindo um comportamento dinâmico de mostrar/ocultar sem JavaScript. A ação é definida na norma ISO 32000-1 §12.6.4.10, Tabela 196
Utilização típica: uma ligação “Mostrar detalhes” / “Ocultar detalhes” na disposição de um formulário, ou grupos de campos mutuamente exclusivos em que clicar numa ligação oculta um grupo e mostra outro (combine duas chamadas AddLinkToHideField com valores HideFlag opostos)
Utilize a função SetAnnotBorderColor para alterar a cor do contorno da área sensível
Sintaxe
Delphi
Function DLAddLinkToHideFieldA(InstanceID: Integer; Left, Top, Width, Height: Double; FieldNames: PAnsiChar; HideFlag, Options: Integer): Integer;DLL
int DLAddLinkToHideFieldA(int InstanceID, double Left, double Top, double Width, double Height, const char * FieldNames, int HideFlag, 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 | Um ou mais 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. Um único nome emite /T como uma cadeia de texto; dois ou mais emitem /T como uma matriz de cadeias de texto |
| HideFlag | Seleciona a direção da visibilidade. Um valor diferente de zero oculta os campos indicados (/H true). Zero mostra-os (/H false) |
| Options | Máscara de bits que controla a aparência da ligação. Bit 0 (valor 1): desenha um limite em torno do retângulo da zona ativa. Os bits 1–3 selecionam o modo de realce do clique (2 = Invert, 4 = Outline, 8 = Push); quando não é definido qualquer bit de realce, é utilizada a predefinição Invert. A convenção é a mesma de AddLinkToWeb / AddLinkToNamedAction |
Observações
A anotação é compatível com PDF/A porque não é referenciado qualquer recurso externo. É necessário PDF 1.2 ou posterior