Vous êtes sur le site Web historique de la documentation de 4D. Les documentations sont progressivement déplacées vers developer.4d.com

Accueil

 
4D v20 R8
Actions standard

Actions standard  


 

Les actions standard peuvent être utilisées de plusieurs manières :

  • en tant qu'actions de boutons et de divers objets de formulaire tels que les cases à cocher et les pop-up menus/listes déroulantes. Les actions peuvent être assignées aux objets de formulaires soit via la Liste des propriétés de l'éditeur de formulaires, soit à l'aide de la commande .
  • en tant qu'actions de commandes de menu. Elles peuvent être assignées aux commandes de menus soit dans l'éditeur de menus (voir Définir l’action d’un menu) soit à l'aide de la commande .
  • en tant qu'actions d'éléments de liste (utilisées lorsque la liste est associée à un pop-up menu/liste déroulante ou à un pop-up menu hiérarchique). Elles peuvent être assignées aux éléments de listes soit dans l'éditeur d'énumérations (voir Créer et modifier des énumérations) soit à l'aide de la commande .
  • en tant que paramètres des commandes et .

Les objets de formulaires et les commandes de menus peuvent se voir affecter à la fois une action standard et une méthode (ce principe permet en particulier de gérer automatiquement l'activation/inactivation de l'élément). Dans ce cas, l'action standard est toujours exécutée après la méthode (à l'exception de l'action deleteRecord, voir ci-dessous).

Certaines actions standard acceptent un paramètre permettant de définir leur exécution. La syntaxe à utiliser est similaire à la syntaxe URL :

 nomActionStandard{?nomParamètre=valeurParamètre}

où :

  • nomActionStandard est le nom de l'action standard (chaîne).
  • nomParamètre (optionnel) est le nom du paramètre à passer (chaîne, généralement "value")
  • valeurParamètre (optionnel) est la valeur à utiliser (chaîne, nombre...)

Par exemple, pour définir l'action "aller à la page 5", vous pouvez écrire :

 gotoPage?value=5

Cette syntaxe est utilisable partout où une action standard peut être définie, c'est-à-dire dans la Liste des propriétés, l'éditeur de menus ou encore dans commandes du langage. Par exemple, dans la Liste des propriétés :

Cette section décrit les actions standard, disponibles dans les formulaires 4D, permettant de manipuler les enregistrements et les pages des formulaires.

Nom actionConstante (si définie)Conditions d'activationDisponible pour (*)Description
"" (chaîne vide)ak noneN/ABoutons, commandes de menusAucune action standard n'est exécutée. Utilisez cette valeur lorsque l’action du bouton devra être définie par une méthode. Par exemple, un bouton qui affiche une boîte de dialogue de recherche personnalisée dans une application avec menus se verrait affecter Pas d’action, car il est nécessaire de définir l’action à l’aide d’une méthode qui ouvre et gère la boîte de dialogue de recherche.
acceptak acceptAucune (peut être gérée par la commande )(**)Boutons, commandes de menusSauvegarde un enregistrement nouveau ou modifié et donc déclenche le trigger Sur sauvegarde nouvel enreg ou Sur sauvegarde enregistrement. L'action valide également un formulaire affiché par . Dans tous les cas, l’événement formulaire Sur validation est généré. 
cancelak cancelAucune (peut être gérée par la commande )(**)Boutons, commandes de menusQuitte l'enregistrement courant sans sauvegarder les modifications éventuellement effectuées. L'action peut également refermer un formulaire affiché par la commande , ou sortir d'un formulaire affichant une sélection d'enregistrements à l'aide de ou .
deleteRecordak delete recordUn enregistrement est sélectionné et il ne s'agit pas d'un nouvel enregistrement en cours d'ajoutBoutons, commandes de menusAffiche une boîte de dialogue d’alerte demandant à l’utilisateur de confirmer la suppression. S’il clique sur le bouton OK, l’enregistrement courant est supprimé. Une fois que l’utilisateur a confirmé l'opération, 4D affiche automatiquement le formulaire Sortie. Cas particulier : si une méthode est également assignée au bouton/menu, l'action standard est appelée en premier et la méthode est exécutée uniquement si l'utilisateur clique sur OK dans la boîte de dialogue d'alerte.
nextRecordak next recordUn enregistrement est sélectionné et il ne s'agit pas du dernier de la sélectionBoutons, commandes de menusValide l’enregistrement courant et fait de l’enregistrement suivant le nouvel enregistrement courant.
previousRecordak previous recordUn enregistrement est sélectionné et il ne s'agit pas du premier de la sélectionBoutons, commandes de menusValide l’enregistrement courant et fait de l’enregistrement précédent le nouvel enregistrement courant.
firstRecordak first recordUn enregistrement est sélectionné et il ne s'agit pas du premier de la sélectionBoutons, commandes de menusValide l’enregistrement courant et fait du premier enregistrement de la sélection le nouvel enregistrement courant.
lastRecordak last recordUn enregistrement est sélectionné et il ne s'agit pas du dernier de la sélectionBoutons, commandes de menusValide l’enregistrement courant et fait du dernier enregistrement de la sélection le nouvel enregistrement courant.
nextPageak next pageFormulaire multipage et on n'est pas sur la dernière pageBoutons, commandes de menusAffiche la page suivante.
previousPageak previous pageFormulaire multipage et on n'est pas sur la première pageBoutons, commandes de menusAffiche la page précédente.
firstPageak next pageFormulaire multipage et on n'est pas sur la première pageBoutons, commandes de menusAffiche la première page.
lastPageak last pageFormulaire multipage et on n'est pas sur la dernière pageBoutons, commandes de menusAffiche la dernière page.
editSubrecordak edit subrecord
  • List box : au moins une ligne d'une list box de type "sélection" est sélectionnée.
  • Sous-formulaire : a le focus et un enregistrement y est sélectionné.
  • Formulaire en liste : un enregistrement est sélectionné dans la liste.
  • Boutons, commandes de menus
  • List box : l'enregistrement correspondant à la ligne de list box est affiché dans le formulaire détaillé associé à la list box. L'utilisateur peut modifier les valeurs, puis valider ou annuler le formulaire afin de retourner à la list box (voir aussi Utiliser des actions standard).
  • Sous-formulaire : le sous-enregistrement sélectionné passe en édition, soit dans la liste, soit dans le formulaire détaillé associé (en fonction des propriétés du sous-formulaire).
  • Formulaire en liste : l'enregistrement sélectionné passe en édition. Avec les listes affichées via les commandes / , la modification est effectuée en liste ou en page en fonction de la valeur du paramètre saisieListe. Dans la fenêtre d’affichage des enregistrements, la modification est effectuée en page (l’action équivaut à double-clic).
  • displaySubrecordak display subrecord
  • List box : au moins une ligne d'une list box de type "sélection" est sélectionnée.
  • Sous-formulaire : a le focus et un enregistrement y est sélectionné.
  • Formulaire en liste : un enregistrement est sélectionné dans la liste.
  • Boutons, commandes de menus
  • List box : l'enregistrement correspondant à la ligne de list box est affiché dans le formulaire détaillé associé à la list box, en mode lecture seulement. L'utilisateur peut uniquement annuler le formulaire afin de retourner à la list box (voir aussi Utiliser des actions standard).
  • Sous-formulaire : le sous-enregistrement sélectionné est affiché dans le formulaire détaillé associé, en mode lecture seulement (en fonction des propriétés du sous-formulaire).
  • Formulaire en liste : avec les listes affichées via les commandes / , l'enregistrement sélectionné est affiché en mode lecture seulement en fonction de la valeur du paramètre saisieListe. Dans la fenêtre d'affichage des enregistrements, l'enregistrement sélectionné est affiché en mode lecture seulement dans la page détaillée.
  • deleteSubrecordak delete subrecord
  • List box : au moins une ligne d'une list box de type "sélection" est sélectionnée.
  • Sous-formulaire : a le focus et un enregistrement y est sélectionné.
  • Formulaire en liste : un enregistrement est sélectionné dans la liste.
  • Boutons, commandes de menus
  • List box : une boîte de dialogue de confirmation apparaît afin que l'utilisateur confirme ou annule la suppression (voir aussi Utiliser des actions standard).
  • Sous-formulaire : une boîte de dialogue de confirmation apparaît afin que l'utilisateur confirme ou annule la suppression du ou des sous-enregistrement(s) sélectionné(s).
  • Formulaire en liste : une boîte de dialogue de confirmation apparaît afin que l'utilisateur confirme ou annule la suppression du ou des enregistrement(s) sélectionné(s).
  • addSubrecordak add subrecord
  • List box : il y a au moins une list box de type "sélection" dans le formulaire et elle a le focus
  • Sous-formulaire : a le focus
  • Formulaire en liste : aucune
  • Boutons, commandes de menus
  • List box : un nouvel enregistrement vierge est affiché dans le formulaire détaillé associé à la list box. L'utilisateur peut saisir des valeurs puis valider, un nouvel enregistrement vierge est automatiquement affiché. Ce principe est répété jusqu'à ce que l'utilisateur clique sur un bouton d'annulation (voir aussi Utiliser des actions standard).
  • Sous-formulaire : 4D crée un nouvel enregistrement dans la table ou une table liée, soit directement dans la liste, soit dans le formulaire détaillé associé (en fonction des propriétés du sous-formulaire).
  • Formulaire en liste : un nouvel enregistrement vierge est créé. Avec les listes affichées via les commandes / l'ajout est effectué en liste ou en page en fonction de la valeur du paramètre saisieListe. Dans la fenêtre d’affichage des enregistrements, l’ajout est effectué en liste.
  • automaticSplitterak automatic splitterAucune (peut être gérée par la commande )Boutons invisiblesCette action standard permet de créer des séparateurs personnalisés dans vos formulaires. Elle ne peut être assignée qu’à un bouton invisible (voir Boutons). Lorsqu’un bouton invisible reçoit cette action automatique, il se comporte exactement comme un séparateur. En collant par exemple une image dans le bouton invisible, vous pouvez créer tout type d’interface personnalisée pour vos séparateurs. Pour plus d’informations sur les séparateurs, reportez-vous à la section Séparateurs.
    gotoPageak goto pageFormulaire multipageOnglets, list box, grilles de boutons, pop-up menus/listes déroulantesAffiche automatiquement la page du formulaire correspondant au numéro de l’élément sélectionné (onglet, ligne de list box, bouton de la grille, élément de pop up menu). Voir aussi Action Aller à page.
    gotoPage?value=<page>ak goto pageFormulaire multipageBoutons, commandes de menusAffiche la page du formulaire correspondant au numéro <page>

    (*) Voir Notes à propos des objets et des actions ci-dessous.
    (**) Lors de l'utilisation de la commande , un élément associé à cette action ne sera pas automatiquement masqué en fonction du contexte.

    Les actions standard suivantes sont utilisables uniquement dans le contexte de formulaires avec Zones Web.

    Nom actionConstante (si définie)Conditions d'activationDisponible pour (*)Description
    openBackURLak open back urlUn URL a été précédemment chargéBoutons, commandes de menusProvoque l’ouverture de l’URL précédent parmi la séquence de navigation effectuée par l’utilisateur dans la zone Web. Désactivée s’il n’y a pas d’URL précédent, c’est-à-dire si l’utilisateur n’a affiché qu’une seule page dans la zone, le bouton ou la commande de menu associé(e) est désactivé(e).
    openForwardURLak open forward urlopenBackURL a été précédemment exécutéBoutons, commandes de menusProvoque l’ouverture de l’URL suivant parmi la séquence de navigation effectuée par l’utilisateur dans la zone Web. Désactivée s’il n’y a pas d’URL suivant, c’est-à-dire si l’utilisateur n’a jamais effectué de retour en arrière dans la séquence.
    refreshCurrentURLak refresh current urlopenBackURL a été précédemment exécuté (peut être gérée par la commande )Boutons, commandes de menusRecharge le contenu courant de la zone Web.
    stopLoadingURLak stop loading urlURL en cours de chargement Boutons, commandes de menusStoppe le chargement de la page et/ou des objets présents à l’URL courant dans la zone Web.

    (*) Voir Notes à propos des objets et des actions ci-dessous.

    Cette section décrit les actions standard permettant d'appeler les boîtes de dialogue 4D ou de quitter l'application 4D.

    Nom actionConstante (si définie)Conditions d'activationDisponible avec (*)Description
    databaseSettingsak database settingsAucune (peut être gérée par la commande )(**)Boutons, commandes de menusAffiche(***) la boîte de dialogue standard des Propriétés de la base.
    quitak quitAucune (peut être gérée par la commande )(**)Boutons, commandes de menusAffiche(***) une boîte de dialogue de confirmation “Etes-vous certain ?” puis quitte l’application 4D en cas de validation. Dans le cas contraire, l’opération est annulée. Lorsque cette action est assignée à un bouton auquel une méthode objet est également associée, la séquence suivante est exécutée : la boîte de dialogue de confirmation apparaît. Si elle est validée, 4D exécute la méthode objet. A l’issue de son exécution, l’application quitte.
    designModeak return to design modeMode application (peut être gérée par la commande )(**)Boutons, commandes de menusFait passer au premier plan les fenêtres et la barre de menus du mode Développement de 4D. Lorsque la base est exécutée en mode interprété, cette action provoque l’affichage de la fenêtre courante du mode Développement. Lorsque la base est exécutée en mode compilé, cette action provoque l’affichage de la fenêtre des enregistrements de la table courante (en mode compilé, seul l’accès aux enregistrements est possible).
    mscak mscAucune (peut être gérée par la commande )(**)Boutons, commandes de menusAffiche la fenêtre du Centre de Sécurité et de Maintenance.

    (*) Voir Notes à propos des objets et des actions ci-dessous.
    (**) Lors de l'utilisation de la commande , un élément associé à cette action ne sera pas automatiquement masqué en fonction du contexte.
    (***) Sous macOS, les commandes de menus associées aux actions Propriétés de la base et Quitter sont automatiquement placées dans le menu de l’application, conformément aux normes d’interface de cette plate-forme.

    Cette section décrit les actions d'édition standard. Ces actions peuvent être utilisées avec :

    • les zones éditables standard,
    • les zones éditables multi-style,
    • les zones 4D Write Pro.
    Nom actionConstante (si définie)Conditions d'activationDisponible avec (*)Description
    undoak undoUne action d'édition a été effectuéeBoutons, commandes de menusAnnule la dernière action effectuée (= commande Annuler du menu Edition). Il ne faut pas confondre cette action avec Ne pas valider (= annulation des modifications éventuellement apportées à l’enregistrement visualisé et retour au formulaire Sortie).
    redoak redoUne action annuler a été effectuéeBoutons, commandes de menusRépète la dernière action annulée (= commande Répéter du menu Edition).
    cutak cutDu contenu est sélectionnéBoutons, commandes de menusSupprime la sélection et la place dans le Presse-papiers
    copyak copyDu contenu est sélectionnéBoutons, commandes de menusPlace une copie de la sélection dans le Presse-papiers.
    pasteak pasteLe presse-papiers n'est pas videBoutons, commandes de menusInsère le contenu du Presse-papiers à l’emplacement du curseur.
    clearak clearL'objet ayant le focus a une zone éditableBoutons, commandes de menusSupprime la sélection. Si rien n’est sélectionné, efface la totalité de la zone contenant le curseur (zones saisissables uniquement).
    selectAllak select allL'objet ayant le focus a une zone éditableBoutons, commandes de menusSélectionne l’ensemble des éléments sélectionnables dans le contexte.
    showClipboardak show clipboardToujours disponibleBoutons, commandes de menusOuvre une nouvelle fenêtre affichant le contenu courant du Presse-papiers.

    Note : Pour que ces actions soient activées, la zone éditable doit avoir le focus (excepté showClipboard).

    (*) Voir Notes à propos des objets et des actions ci-dessous.

    Les actions standard suivantes peuvent être utilisées avec :

    • les zones éditables multi-style (aussi appelées zones de texte riche),
    • les zones 4D Write Pro.

    Note : Des actions supplémentaires sont disponibles pour les zones 4D Write Pro. Elles sont décrites dans la section Utiliser les actions standard 4D Write Pro du manuel de référence de 4D Write Pro. 

    Police  

    Nom actionConstante (si définie)Conditions d'activationDisponible avec (*)Description
    backgroundColorak background colorAucuneCommandes de menus, Pop-up/Listes déroulantes, Pop-up menus hiérarchiquesAffiche le sous-menu standard de couleur de fond
    backgroundColor?value=<color>ak background colorAucuneBoutons, commandes de menus, éléments de listesDéfinit <color> comme couleur de fond de la police. Passez une valeur ou un nom de couleur Css. Ex : backgroundColor?value=#FF0000, backgroundColor?value=red, backgroundColor?value=transparent 
    backgroundColor/showDialogak background color dialogAucuneBoutons, commandes de menusAffiche la boîte de dialogue de couleur de fond de police
    colorak font colorAucuneCommandes de menus, Pop-up/Listes déroulantes, Pop-up menus hiérarchiquesAffiche le sous-menu standard de couleur de police
    color?value=<color>ak font colorAucuneBoutons, commandes de menus, éléments de listesDéfinit <color> comme couleur de police. Passez une valeur ou un nom de couleur Css. Ex : color?value=#FF0000, color?value=red
    color/showDialogak font color dialogAucuneBoutons, commandes de menusAffiche la boîte de dialogue système de couleur de police
    font/showDialogak font show dialogAucuneBoutons, commandes de menusAffiche la boîte de dialogue système de sélecteur de police.
    fontItalicak font italicAucuneBoutons, commandes de menusSélectionne/désélectionne l'attribut de police italique.
    fontBoldak font boldAucuneBoutons, commandes de menusSélectionne/désélectionne l'attribut de police gras.
    fontLinethroughak font linethroughAucuneBoutons, commandes de menusSélectionne/désélectionne l'attribut de police barré
    fontSizeak font sizeAucuneCommandes de menus, Pop-up/Listes déroulantes, Pop-up menus hiérarchiquesAffiche le sous-menu standard de taille de police
    fontSize?value=<size>ak font sizeAucuneBoutons, commandes de menus, éléments de listesDéfinit <size> comme taille de police. Passez une taille Css en pt. Ex : fontSize?value=12pt
    fontUnderlineak font underlineAucuneBoutons, commandes de menusSélectionne/désélectionne l'attribut de police souligné.
    fontStyleak font styleAucuneCommandes de menus, Pop-up/Listes déroulantes, Pop-up menus hiérarchiquesAffiche le sous-menu standard de style de police.

    (*) Voir Notes à propos des objets et des actions ci-dessous.

    Note : Lorsqu'un attribut de style est modifié via une action standard, 4D génère un événement formulaire Sur après modification.

    Nom actionConstante (si définie)Conditions d'activationDisponible avec (*)Description
    computeExpressionsak compute expressionsAucuneBoutons, commandes de menusMet à jour toutes les expressions dynamiques dans la zone.
    freezeExpressionsak freeze expressionsAucuneBoutons, commandes de menusFige toutes les expressions dynamiques dans la zone.
    visibleReferencesak show referenceAucuneBoutons, commandes de menusAffiche toutes les expressions dynamiques en tant que références.

    (*) Voir Notes à propos des objets et des actions ci-dessous.

    Les actions de correction orthographique sont disponibles uniquement si l'option Correction orthographique est sélectionnée pour la zone.

    Nom actionConstante (si définie)Conditions d'activationDisponible avec (*)Description
    spell/autoCorrectionEnabled-Correction orthographique activéeBoutons, commandes de menusActive/désactive le mode correction auto.
    spell/autoDashSubstitutionsEnabled-Correction orthographique activéeBoutons, commandes de menusActive/désactive le remplacement des double tirets (--) par le tiret cadratin (—) en cours de saisie (macOS uniquement).
    spell/autoLanguageEnabled-Correction orthographique activéeBoutons, commandes de menusActive/désactive l'identification automatique de la langue du dictionnaire à utiliser en fonction du contenu du texte (macOS uniquement).
    spell/autoQuoteSubstitutionsEnabled-Correction orthographique activéeBoutons, commandes de menusActive/désactive le remplacement des guillemets droits par des guillemets typographiques adaptés à la langue courante (macOS uniquement).
    spell/autoSubstitutionsEnabled-Correction orthographique activéeBoutons, commandes de menusActive/désactive la substitution de texte.
    spell/enabled-AucuneBoutons, commandes de menusActive/désactive la correction orthographique dans la zone (l'option Correction orthographique doit être cochée pour la zone).
    spell/forgetIgnore-Correction orthographique activéeBoutons, commandes de menusEfface la liste des mots ayant été déclarés ignorés dans le document.
    spell/grammarEnabled-Correction orthographique activéeBoutons, commandes de menusActive/désactive la correction grammaticale du texte (macOS uniquement).
    spell/ignore-Correction orthographique activée/Un mot inconnu est sélectionné ou contient le curseurBoutons, commandes de menusLe mot inconnu est conservé tel quel et n’est plus souligné, mais il sera de nouveau signalé s’il est détecté ultérieurement.
    spell/learn-Correction orthographique activée/Un mot inconnu est sélectionné ou contient le curseurBoutons, commandes de menusLe mot inconnu est ajouté au dictionnaire ; il ne sera plus signalé par le correcteur.
    spell/removeSubstitution-Correction orthographique activée/Un mot ayant été substitué est sélectionné ou contient le curseurBoutons, commandes de menusSupprime la substitution sélectionnée.
    spell/showDialog-Correction orthographique activéeBoutons, commandes de menusAffiche une boîte de Correction orthographique.
    spell/suggestion?index=<1<=nombre<=10>-Correction orthographique activée/mot incorrect sélectionnéBoutons, commandes de menusnombre est le énième suggestion d'orthographe pour le premier mot incorrect dans la sélection. Ex : spell/suggestion?index=1 remplacera le mot incorrect dans la sélection par la première suggestion.
    spell/unLearn-Correction orthographique activée/Un mot appris est sélectionné ou contient le curseurBoutons, commandes de menusSupprimer le mot de la liste des mots appris.
    spell/visibleSubstitutions-Correction orthographique activéeBoutons, commandes de menusActive/désactive le soulignement en bleu des substitutions possibles dans le texte.
    spell-NoneCommandes de menusAffiche le menu complet du correcteur orthographique.

    (*) Voir Notes à propos des objets et des actions ci-dessous.

    • Boutons désigne les boutons standard, boutons 3D, boutons inversés, boutons image et boutons invisibles. Inclut également les cases à cocher et les cases à cocher 3D, qui peuvent représenter des actions avec statut vrai/faux, par exemple "fontBold" (l'option trois états est prise en charge avec les cases à cocher standard uniquement). 
    • Les objets Pop-up/Listes déroulantes et Pop-up menus hiérarchiques peuvent uniquement être associés aux actions standard qui génèrent un sous-menu (liste), telles que "backgroundColor" ou "fontSize". Dans ce cas, ils affichent une liste automatique de valeurs, à moins que des actions standard personnalisées aient été définies pour les éléments de la liste (voir ci-dessous).
    • Eléments de liste : Si vous ne souhaitez pas utiliser les valeurs automatiques des actions standard, vous pouvez associer des actions standard personnalisées aux éléments d'une liste (à l'aide de l'éditeur d'énumérations ou de la commande ) et définir la liste comme "Enumération" pour l'objet Pop-up/Liste déroulante ou Pop-up menu hiérarchique. Les valeurs automatiques seront alors remplacées par les actions personnalisées à l'exécution. Dans ce contexte, seules les actions standard avec paramètres de valeurs en relation avec l'action principale du sous-menu (liste) peuvent être utilisées. Par exemple, vous pouvez définir une liste d'éléments associés à des valeurs d'actions backgroundColor (backgroundColor?value="red", backgroundColor?value="blue"...) et l'affecter comme Enumération à un pop-up menu hiérarchique.



    Voir aussi  

    Download HDI database
    Utiliser des actions standard

     
    PROPRIÉTÉS 

    Produit : 4D
    Thème : Propriétés des objets actifs
    Nom intl. : Standard actions

     
    PAGE CONTENTS 
     
    HISTORIQUE 

    Modifié : 4D v16 R3
    Modifié : 4D v16 R4

     
    UTILISATION DE L'ARTICLE

    4D - Mode Développement ( 4D v20 R8)