SetFormFieldActionEx

Campos de formulário, anotações e ligações de zonas interativas

Descrição

Constrói e atribui uma ação de acionador de campo de formulário usando um nome de evento e uma constante de construtor de ação nomeada

Sintaxe

Delphi

Function TPDFlib.SetFormFieldActionEx(Index: Integer; Const EventName: WideString; ActionKind: Integer; Const Value, FieldNames: WideString; Flags, DestID: Integer): Integer;

Parâmetros

IndexO índice do campo de formulário com base 1
EventNameO nome do evento de acionamento, tal como MouseUp, MouseDown, MouseEnter, MouseExit, Focus, LostFocus, KeyPress, BeforeFormatting, Change ou Calculate
ActionKindUma das constantes PDF_ACTION_BUILDER_* suportadas por AddActionNextEx
ValueO URI, a ação nomeada, o código-fonte JavaScript, o nome do ficheiro de importação de dados, ou um valor não usado para ações de destino
FieldNamesUma lista de campos separada por vírgulas para ações hide, submit e reset
FlagsSinalizadores específicos da ação ou o índice de thread com base 1 para PDF_ACTION_BUILDER_THREAD
DestIDO handle de destino para PDF_ACTION_BUILDER_DESTINATION, ou um índice de conta com base 1 para PDF_ACTION_BUILDER_THREAD, com 0 a selecionar a primeira conta

Valores devolvidos

0O campo, o nome de evento, o tipo de ação ou o valor exigido era inválido, ou o modo PDF/X-6 está ativo
1A ação foi construída e atribuída ao evento do campo selecionado

Observações

Este auxiliar combina a resolução do nome de evento com a construção da ação, evitando handles de ação temporários separados quando um evento de campo só precisa de uma ação direta de URI, JavaScript, hide, submit, reset, import-data, nomeada, de destino ou de Thread de artigo As ações adicionais de campos de formulário são recusadas enquanto o modo PDF/A ou PDF/X-6 estiver ativo, porque ambos os perfis proíbem dicionários

/AA de campos e widgets, mesmo quando o tipo de ação selecionado seria de outra forma permitido