AddLinkToHideField
Anotações e links de zona ativa, Campos de formulário e AcroForms
Descrição
Adiciona um retângulo de ponto ativo clicável à página selecionada 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, Table 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 mostra outro (combine duas chamadas de AddLinkToHideField com valores HideFlag opostos)
Use a função SetAnnotBorderColor para alterar a cor da borda do ponto ativo
Sintaxe
Delphi
Function TPDFlib.AddLinkToHideField(Left, Top, Width, Height: Double; Const FieldNames: WideString; HideFlag: Integer; Options: Integer): Integer;DLL
int DLAddLinkToHideField(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FieldNames, int HideFlag, int Options);Parâmetros
| Left | A coordenada horizontal da borda esquerda do retângulo do ponto ativo |
|---|---|
| Top | A coordenada vertical da borda superior do retângulo do ponto ativo |
| Width | A largura do retângulo do ponto ativo |
| Height | A altura do retângulo do ponto ativo |
| FieldNames | Um ou mais nomes de campos AcroForm totalmente qualificados, separados por vírgulas, ponto e vírgula ou quebras de linha. Espaços em branco à esquerda e à direita ao redor de cada nome são removidos. Um único nome emite /T como uma sequência de texto; dois ou mais emitem /T como um array de sequências de texto |
| HideFlag | Seleciona o sentido 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): desenha uma borda ao redor do retângulo do ponto ativo. 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. Mesma convenção de AddLinkToWeb / AddLinkToNamedAction |
Observações
Os modos PDF/A e PDF/X-6 rejeitam ações Hide e retornam 0; é necessário PDF 1.2 ou posterior