Saltar al contenido principal
Versión: Siguiente

Get action info

Get action info ( action {; objetivo} ) -> Resultado

ParámetroTipoDescripción
actionCadena🡒Nombre o patrón de acción estándar incluyendo el parámetro si es necesario
objetivoEntero largo🡒Define el objetivo de la acción para obtener información: forma principal o forma actual
ResultadoObjeto🡐Objeto que contiene el estado de la acción como propiedades booleanas: isEnabled, isVisible, isChecked, isMixed, isUnknownState

Descripción

El comando Get action info devuelve diferente información, incluida la disponibilidad y el estado, sobre la accion definida en el objetivo, de acuerdo con el contexto de la aplicación actual.

En accion, pase el nombre de la acción estándar a verificar. Puede ser una cadena o una constante del tema Acción estándar. Puede ser una cadena o una constante del tema Acción estándar. Algunas acciones aceptan un elemento objetivo y parámetros. En este caso, debe utilizar el patrón solicitado, por ejemplo "gotoPage?value=2" or paragraph/backgroundPositionV?value=top.

La lista detallada de acciones se ofrece en la sección Acciones estándar del manual de Diseño 4D.

Nota: También se ofrecen acciones específicas adicionales para los documentos 4D Write Pro. Se detallan en la sección Utilizar las acciones estándar 4D Write Pro del manual de referencia de 4D Write Pro.

Puede pasar en objetivo el contexto del formulario en el que se debe ejecutar la accion, si está disponible. Puede utilizar una de las siguientes constantes del tema Acción estándar:

ConstanteTipoValorComentario
ak current formEntero largo1El formulario actual es el formulario donde se llamó la acción. Podría ser el formulario principal o un formulario tipo paleta delante del formulario principal del proceso actual.
ak main formEntero largo2El formulario principal es el documento más adelante o el formulario diálogo del proceso, excluyendo cualquier ventana flotante o emergente.

Nota: si se omite el objetivo, se utiliza por defecto el contexto ak current form.

El comando Get action info devuelve información en forma de un objeto que contiene las siguientes propiedades:

PropiedadTipoDescripción
activadoBooleanotrue si se puede invocar la acción, false en caso contrario
estadoCadenaEl valor puede ser una de las siguientes cadenas:
"seleccionada"la acción está seleccionada, lo que significa que la propiedad está definida. Ejemplo: el texto seleccionado está en negrita, la propiedad "estado" de la acción estándar ak font bold contiene "seleccionado"
"no seleccionado" la acción estándar no está seleccionada, lo que significa que la propiedad no está definida. Ejemplo: el texto seleccionado no está en negrita, la propiedad "estado" de la acción estándar ak font bold contiene "no seleccionado".
"combinada"la acción es combinada, lo que significa que la propiedad está parcialmente definida. Ejemplo: arte del texto seleccionado está en "negrita", la propiedad "estado" de la acción estándar ak font bold contiene "combinada".
títuloTextNombre actual localizado de la etiqueta de acción. Ejemplo: "Deshacer, "Pegar", etc. para la versión en inglés.
visibleBooleanotrue si la acción es visible en el formulario
valorCadenaValor actual de la cadena de parámetros de acción (si existe). Por ejemplo, si la acción estándar es "fontSize?value=10pt", la propiedad valor contiene "10pt"

Si no se puede determinar el estado de la acción (por ejemplo, si no se afecta a ningún objeto o comando de menú), el comando devuelve un objeto nulo (indefinido).

Ejemplo

Desea saber si la acción copiar está disponible (es decir, si se han seleccionado algunos datos):

 var $actionInfo : Object
 var $isEnabled : Boolean
 $actionInfo:=Get action info(ak copy)
 If(Not(Undefined($actionInfo.enabled))) //la acción es definida en el proceso
    If(OB Get($actionInfo;"enabled"))
       ... //la acción copiar está disponible
    End if
 End if

Ver también

INVOKE ACTION
SET LIST ITEM PARAMETER