AddLinkToHideFieldA
Anotações e links de hotspot, Campos de formulário e AcroForms
Descrição
O A final indica o ponto de entrada DLL ANSI (char); a superfície ActiveX/COM expõe apenas a forma Unicode. O comportamento é idêntico ao de AddLinkToHideField e os argumentos string são interpretados usando a página de código atual de SetAnsiMode
Adiciona à página selecionada um retângulo de hotspot clicável que dispara uma ação hide do PDF quando ativado. Uma ação hide alterna a visibilidade de um ou mais campos AcroForm, permitindo comportamento dinâmico de mostrar/ocultar sem JavaScript. A ação é definida na ISO 32000-1 §12.6.4.10, Tabela 196
Uso típico: um link “Mostrar detalhes” / “Ocultar detalhes” em um layout de formulário, ou grupos de campos mutuamente exclusivos, em que clicar em um link oculta um grupo e exibe outro (combine duas chamadas a AddLinkToHideField com valores de HideFlag opostos).
Use a função SetAnnotBorderColor para alterar a cor da borda do hotspot
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 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 | Um ou mais nomes de campos AcroForm totalmente qualificados, separados por vírgulas, ponto e vírgula ou quebras de linha. Espaços no início e no fim de cada nome são aparados. Um único nome emite /T como text string; dois ou mais emitem /T como um array de text strings. |
| HideFlag | Seleciona a direção da visibilidade. Um valor diferente de zero oculta os campos listados (/H true). Zero os exibe (/H false). |
| Options | Máscara de bits que controla a aparência do link. Bit 0 (valor 1): desenhar uma borda ao redor do retângulo da zona ativa. 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. Same convention as AddLinkToWeb / AddLinkToNamedAction. |
Observações
A anotação é compatível com PDF/A porque nenhum recurso externo é referenciado. É necessário PDF 1.2 ou posterior