4D v18
Get action info
Get action info
| Get action info ( action {; objetivo} ) -> Resultado | ||||||||
| Parámetro | Tipo | Descripción | ||||||
| action | Cadena |
|
Nombre o patrón de acción estándar incluyendo el parámetro si es necesario | |||||
| objetivo | Entero largo |
|
Define el objetivo de la acción para obtener información: forma principal o forma actual | |||||
| Resultado | Objeto |
|
Objeto que contiene el estado de la acción como propiedades booleanas: isEnabled, isVisible, isChecked, isMixed, isUnknownState | |||||
El comando Get action info devuelve varias informaciones, 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. La lista detallada de acciones se ofrece en la sección Acciones estándar del manual de Diseño 4D.
Nota: algunas acciones aceptan parámetros. En este caso, debe utilizar el patrón siguiente: actionName?parameterName=parameterValue. Ejemplo: "gotoPage?value=2"
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:
| Constante | Tipo | Valor | Comentario |
| ak current form | Entero largo | 1 | El 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 form | Entero largo | 2 | El 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:
| Propiedad | Tipo | Descripción | ||||||
| activado | Booleano | true si se puede invocar la acción, false en caso contrario | ||||||
| estado | Cadena | El valor puede ser una de las siguientes cadenas:
| ||||||
| título | Text | Nombre actual localizado de la etiqueta de acción. Ejemplo: "Deshacer, "Pegar", etc. para la versión en inglés. | ||||||
| visible | Booleano | true si la acción es visible en el formulario | ||||||
| valor | Cadena | Valor 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).
Desea saber si la acción copiar está disponible (es decir, si se han seleccionado algunos datos):
C_OBJECT($actionInfo)
C_BOOLEAN($isEnabled)
$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
Producto: 4D
Tema: Lenguaje
Número
1442
Creado por: 4D v16 R3
Modificado: 4D v16 R4
Manual de lenguaje 4D ( 4D v18)
