OBJECT Get action
OBJECT Get action ( {* ;} objeto ) : Text
Parâmetro | Tipo | Descrição | |
---|---|---|---|
* | Operador | → | Se for especificado, objeto è um nome de objeto (string). Se omitido, objeto é um campo ou variável |
objeto | any | → | Nome de Objeto (se * for especificado) ou Campo ou variável (se * for omitido) |
Resultado | Text | ← | Nome da ação padrão associada e (se houver) parâmetro string |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
O comando OBJECT Get action devolve o nome e (se for o caso) o parâmetro da ação padrão associada com o objeto designado pelos parâmetros objeto e *.
Passar o parámetro opcional * indica que o parâmetro objeto é um nome de objeto (string). Se não passar este parâmetro, indica que o parâmetro objeto for um campo ou uma variável. Neste caso, se passar uma referência de campo ou variável ao invés de uma string (só objeto campo ou variável).
Pode estabelecer uma ação padrão para um objeto no Editor de formulários utilizando a lista de propriedades ou utilizando o comando OBJECT SET ACTION. OBJECT Get action devolve uma string que contenha o nome da ação padrão associada ao objeto (assim como seu parâmetro, se existir).
Para obter uma lista completa de ações padrão, consulte a seção Ações padrões no manual de Desenho.
Exemplo
Se quiser associar a ação "Cancelar" com todos os objetos no formulário que ainda não têm nenhuma ação associada:
ARRAY TEXT($arrObjects;0)
FORM GET OBJECTS($arrObjects)
For($i;1;Size of array($arrObjects))
If(OBJECT Get action(*;$arrObjects{$i})=ak none)
OBJECT SET ACTION(*;$arrObjects{$i};ak cancel)
End if
End for