Saltar para o conteúdo principal
Versão: Próximo

Action info

Action info ( ação {; alvo} ) : Object

ParâmetroTipoDescrição
açãoTextNome da ação padrão ou padrão incluindo parâmetro se exigido
alvoIntegerDefine o alvo da ação para obter informação: formulário principal ou atual
ResultadoObjectObjeto que contém status da ação como propriedade booleana: isEnabled, isVisible, isChecked, isMixed, isUnkownState

Descrição

O comando Action info devolve várias informações, incluida a disponibilidade e o estado, sobre a ação definida no objetivo, de acordo com o contexto da aplicação atual.

Em ação, passe o nome da ação padrão a verificar. Pode ser uma string ou uma constante de tema Ação estandarte. Algumas ações aceitam parâmetros. Neste caso, deve utilizar o padrão seguinte: actionName?parameterName=parameterValue. Exemplo: "gotoPage?value=2"

Ações 4D disponíveis estão listadas na seção Ações padrões do manual 4D Design Reference.

Nota: Ações especificas adicionais são oferecidas para documentos 4D Write Pro. Estão detalhadas na seção Usando ações padrão do manual 4D Write Pro Reference manual.

Pode passar em objetivo o contexto de formulário no qual se deve executar a ação, se estiver disponível. Pode utilizar uma das seguintes constantes de tema Ação estandarte:

ConstanteTipoValorComentário
ak current formInteiro longo1O 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 formInteiro longo2O 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 o objetivo, se utiliza por padrão o contexto ak current form.

O comando Action info devolve informação em forma de um objeto que contenha as seguintes propriedades:

PropriedadeTipoDescrição
ativadoBooleanotrue se puder invocar a ação, falso se contrário
estadoTextO valor pode ser uma das seguintes strings:
"selecionada"a ação está selecionada, o que significa que a propriedad está definida. Exemplo: o texto selecionado está em negrito, a propriedade "estado" da ação padrão ak font bold contém "selecionado"
"não selecionado" a ação padrão não está selecionada, o que significa que a propriedade não está definida. Exemplo: o texto selecionado não está em negrito, a propriedade "estado" da ação padrão ak font bold contém "não selecionado".
"combinada"a ação é combinada, o que significa que a propriedade está parcialmente definida. Exemplo: arte de texto selecionado está em "negrito", a propriedade "estado" da ação padrão ak font bold contém "combinada".
títuloTextNome atual localizado da etiqueta de ação. Exemplo: "Undo "
visívelBooleanotrue se a ação for visível no formulário
valueTextValor atual do parâmetro ação string (se houver). Por exemplo, se a ação padrão for "fontSize?value=10pt", a propriedade valor contém "10pt"

]

Se não pode ser determinado o estado da ação (por exemplo, se não afetar a nenhum objeto ou comando de menu), o comando devolve um objeto nulo (indefinido).

Exemplo

Se quiser saber se a ação copiar está disponível (ou seja, se foram selecionados alguns dados):

 var $actionInfo : Object
 var $isEnabled : Boolean
 $actionInfo:=Action info(ak copy)
 If(OB Is defined($actionInfo.enabled)) //a ação é definida no processo
    If(OB Get($actionInfo;"enabled"))
  //a ação copiar está disponível
    End if
 End if

Ver também

INVOKE ACTION
SET LIST ITEM PARAMETER

Propriedades

Número do comando1442
Thread-seguro