4D v19
Lire info action
Lire info action
| Lire info action ( action {; cible} ) -> Résultat | ||||||||
| Paramètre | Type | Description | ||||||
| action | Chaîne |
|
Nom de l'action standard ou syntaxe incluant un paramètre si celui-ci est requis | |||||
| cible | Entier long |
|
Définit la cible de l'action où lire les informations : formulaire principal ou formulaire courant | |||||
| Résultat | Objet |
|
Objet contenant le statut de l'action sous forme de booléens : isEnabled, isVisible, isChecked, isMixed, isUnknownState | |||||
La commande Lire info action retourne plusieurs informations, incluant la disponibilité et le statut à propos de l'action définie dans la cible, selon le contexte de l'application courante.
Dans action, passez le nom de l'action standard à vérifier. Ce peut être une chaîne ou une constante du thème Action standard. La liste détaillée des actions est fournie dans la section Actions standard du manuel 4D - Mode Développement.
Note : Quelques actions acceptent un ou des paramètre(s). Dans ce cas, vous devez utiliser la syntaxe suivante : actionName?parameterName=parameterValue. Exemple: "gotoPage?value=2"
Vous pouvez passer dans cible le contexte formulaire où l'action doit être exécutée. Vous pouvez utiliser une des constantes suivantes, du thème Action standard :
| Constante | Type | Valeur | Comment |
| ak current form | Entier long | 1 | Le formulaire courant est le formulaire depuis lequel l'action a été appelée. Il peut s'agir soit du formulaire principal du process courant soit d'un formulaire palette situé au-dessus du formulaire principal. |
| ak main form | Entier long | 2 | Le formulaire principal est le document ou le formulaire de dialogue au premier plan du process, sans tenir compte des fenêtres palettes ou flottantes. |
Note : Si cible est omis, par défaut, c'est le contexte ak current form qui est utilisé.
La commande Lire info action retourne les informations sous la forme d'un Objet contenant les propriétés ci-dessous :
| Propriété | Type | Description | ||||||
| enabled | Booléen | true si l'action peut être appelée, false sinon. | ||||||
| status | Chaîne | Les valeurs de la propriété "status" peuvent être une des chaînes suivantes :
| ||||||
| title | Texte | libellé courant et localisé de l'action. Ex: "Annuler", "Coller", etc. pour la version française. | ||||||
| visible | Booléen | true si l'action est visible dans le formulaire | ||||||
| value | Chaîne | Valeur courante de la chaîne de paramètre d'action (s'il y en a). Par exemple, si l'action standard est "fontSize?value=10pt", la propriété value contient "10pt" |
Si le statut de l'action ne peut pas être déterminé (par exemple si elle n'est affectée à aucun objet ou à aucune ligne de menu), la commande retourne un objet null (indéfini).
Vous voulez savoir si l'action standard Copier est disponible (c'est-à-dire si des données sont sélectionnées) :
C_OBJET($actionInfo)
C_BOOLEEN($isEnabled)
$actionInfo:=Lire info action(ak copy)
Si(Non(Indefinie($actionInfo.enabled)) //l'action est définie dans le process
Si(OB Lire($actionInfo;"enabled"))
... //la copie est disponible
Fin de si
Fin de si
Produit : 4D
Thème : Langage
Numéro :
1442
Nom intl. : Get action info
Créé : 4D v16 R3
Modifié : 4D v16 R4
4D - Langage ( 4D v19)
4D - Langage ( 4D v19.1)
