INVOKE ACTION

4D v19

INVOKE ACTION


INVOKE ACTION ( ação {; alvo} )

Parâmetro	Tipo	Descrição
ação	String	Nome ação padrão ou padrão incluindo parâmetro se exigido
alvo	Inteiro longo	Define onde executar a ação: formulário atual (padrão) ou formulário principal

Descrição

O comando INVOKE ACTION ativa a ação padrão definida pelo parâmetro ação, opcionalmente no contexto objetivo.

Em ação, passe o nome da ação padrão a executar. Pode ser uma string ou uma constante de tema Ação estandarte.

Todas as ações disponíveis são listadas na seção Ações padrões do manual de Desenho 4D.

Notas:

Algumas ações aceitam um parâmetro. Neste caso, deve utilizar o padrão seguinte: actionName?parameterName=parameterValue. Exemplo: "gotoPage?value=2"
Também são oferecidas ações específicas adicionais para os documentos 4D Write Pro. São detalhadas na seção Usando ações padrão de manual 4D Write Pro Reference.

Em objetivo, pode passar o contexto de formulário no que se deve executar a ação. Pode utilizar uma das seguintes constantes de tema Ação estandarte:

Constante	Tipo	Valor	Comentário
ak current form	Inteiro longo	1	O formulário atual é o formulário onde se chamou a ação. Poderia ser o formulário principal ou um formulário tipo paleta diante do formulário principal do processo atual.
ak main form	Inteiro longo	2	O formulário principal é o documento mais a frente ou o formulário diálogo do processo, excluindo qualquer janela flutuante ou pop up

Nota: se for omitido objetivo, é utilizado como padrão o contexto ak current form.

Dependendo do objetivo, a execução do comando INVOKE ACTION é sincrônica ou assincrônica:

Com ak current form como objetivo, o comando INVOKE ACTION é sincrônico; a ação é executada no ciclo atual no momento em que se chama ao comando.
Com ak main form como objetivo, o comando INVOKE ACTION é assincrônico; a ação é executada no seguinte ciclo depois do final da execução do método objeto de formulário.

Nota: as ações de edição padrão (Cortar, Copiar, Colar, Selecionar tudo, Apagar, Desfazer/Refazer) ignoram o parâmetro objetivo, se for passado. Tais ações podem ser executadas sempre de forma sincrônica no contexto de objeto editável que tenha o foco.

O comando INVOKE ACTION não gera um erro, por exemplo, se a ação solicitada não estiver disponível no contexto atual. Deve validar a ação esperada utilizando o comando Get action info.

Exemplo 1

Se quiser executar a ação padrão Copiar no formulário atual:

INVOKE ACTION(ak copy;ak current form)

Exemplo 2

Se quiser executar uma ação padrão Goto page (página 3) no formulário principal:

INVOKE ACTION(ak goto page+"?value=3";ak main form)

Ver também

Get action info