Aller au contenu principal
Version: v20

Action


Glissable

Contrôlez si l'utilisateur peut faire glisser l'objet et comment il peut le faire. Par défaut, aucune opération de glisser n'est autorisée.

Deux modes de glisser-déposer sont proposés dans 4D :

  • Un mode personnalisé, dans lequel le glisser déclenche l'événement formulaire Sur début glisser dans le contexte de l'objet. Vous gérez ensuite le glisser à l'aide d'une méthode.
    En mode personnalisé, le glisser-déposer est géré par le programmeur. Ce mode vous permet de mettre en place des interfaces basées sur le glisser-déposer, y compris des interfaces qui ne déplacent pas nécessairement des données mais qui peuvent effectuer tout type d'action, telle que l'ouverture de fichiers ou le lancement d'un calcul. Ce mode est basé sur un ensemble de propriétés, d'événements et de commandes spécifiques à partir du thème Conteneur de données.
  • Un mode automatique, dans lequel 4D copie du texte ou des images directement à partir de l'objet formulaire. Il peut alors être utilisé dans la même zone 4D, entre deux zones 4D, ou entre 4D et une autre application. For example, automatic drag (and drop) lets you copy a value between two fields without using programming:

    In this mode, the On Begin Drag form event is NOT generated. Si vous souhaitez "forcer" l'utilisation du glissement personnalisé alors que le glissement automatique est activé, maintenez la touche Alt (Windows) ou Option (macOS) enfoncée pendant l'action. Cette option n'est pas disponible pour les images.

Pour plus d'informations, reportez-vous à Glisser-déposer dans le manuel Langage 4D.

Grammaire JSON

NomType de donnéesValeurs possibles
draggingtext"none" (par défaut), "custom", "automatic" (hors list box)

Objets pris en charge

Zones 4D Write Pro - Zone de saisie - Liste hiérarchique - List Box - Zone de plug-in

Voir également

Déposable


Déposable

Contrôlez si et comment l'objet peut être la destination d'une opération de glisser-déposer.

Deux modes de glisser-déposer sont proposés dans 4D :

  • Un mode personnalisé, dans lequel le déposer déclenche les événements formulaire Sur glisser et Sur déposer dans le contexte de l'objet. Vous gérez ensuite le déposer à l'aide d'une méthode.
    En mode personnalisé, le glisser-déposer est géré par le programmeur. Ce mode vous permet de mettre en place des interfaces basées sur le glisser-déposer, y compris des interfaces qui ne déplacent pas nécessairement des données mais qui peuvent effectuer tout type d'action, telle que l'ouverture de fichiers ou le lancement d'un calcul. Ce mode est basé sur un ensemble de propriétés, d'événements et de commandes spécifiques à partir du thème Conteneur de données.
  • Un mode automatique, dans lequel 4D gère automatiquement — si possible — l’insertion des données glissées de type texte ou image et déposées sur l’objet (les données sont collées dans l’objet). Les événements Sur glisser et Sur déposer ne sont pas générés. En revanche, les événements Sur après modification (lors du déposer) et Sur données modifiées (lorsque l'objet perd le focus) sont générés.

Pour plus d'informations, reportez-vous à Glisser-déposer dans le manuel Langage 4D.

Grammaire JSON

NomType de donnéesValeurs possibles
droppingtext"none" (par défaut), "custom", "automatic" (hors list box)

Objets pris en charge

Zones 4D Write Pro - Bouton - Zone de saisie - Liste hiérarchique - List Box - Zone de plug-in

Voir également

Glissable


Exécuter méthode objet

Lorsque cette option est activée, la méthode objet est exécutée avec l'événement Sur données modifiées au même moment où l'utilisateur change la valeur de l'indicateur. Lorsque l'option est désactivée, la méthode est exécutée après la modification.

Grammaire JSON

NomType de donnéesValeurs possibles
continuousExecutionbooleantrue, false

Objets pris en charge

Indicateur de progression - Règle - Stepper


Méthode

Référence d'une méthode attachée à l'objet. Les méthodes d'objet "gèrent" généralement l'objet pendant que le formulaire est affiché ou imprimé. Vous n'appelez pas de méthode objet - 4D l'appelle automatiquement lorsqu'un événement implique l'objet auquel la méthode objet est rattachée.

Plusieurs types de références de méthode sont pris en charge :

  • un chemin de fichier de méthode objet standard, c'est-à-dire qui utilise le modèle suivant :
    ObjectMethods/objectName.4dm
    ... où objectName est le nom de l'objet. Ce type de référence indique que le fichier de méthode se trouve à l'emplacement par défaut ("sources/forms/formName/ObjectMethods/"). Dans ce cas, 4D gère automatiquement la méthode objet lorsque des opérations sont exécutées sur l'objet formulaire (renommage, duplication, copier/coller, etc.)

  • a project method name: name of an existing project method without file extension, i.e.: myMethod In this case, 4D does not provide automatic support for object operations.

  • a custom method file path including the .4dm extension, e.g.:
    ../../CustomMethods/myMethod.4dm You can also use a filesystem:
    /RESOURCES/Buttons/bOK.4dm In this case, 4D does not provide automatic support for object operations.

Grammaire JSON

NomType de donnéesValeurs possibles
methodtextChemin de fichier standard ou personnalisé de la méthode objet ou nom de la méthode projet

Objets pris en charge

Plusieurs types de références de méthode sont pris en charge :


Lignes déplaçables

List box de type tableau

Autorise le déplacement des lignes pendant l'exécution. Cette option est sélectionnée par défaut. Il n'est pas disponible pour les list box de type sélection ni pour les list box en mode hiérarchique.

Grammaire JSON

NomType de donnéesValeurs possibles
movableRowsbooleantrue, false

Objets pris en charge

List Box


Multi-sélectionnable

Allows the selection of multiple records/options in a hierarchical list.

Grammaire JSON

NomType de donnéesValeurs possibles
selectionModetext"multiple", "single", "none"

Objets pris en charge

Liste hiérarchique


Triable

Permet de trier les données de colonne en cliquant sur un en-tête de Listbox. Cette option est sélectionnée par défaut. Les tableaux de types d'image (colonnes) ne peuvent pas être triés à l'aide de cette fonction.

Dans les list box basées sur une sélection d'enregistrements, la fonction de tri standard est disponible uniquement :

  • Lorsque la source de données est Sélection courante,
  • Avec des colonnes associées à des champs (de type Alpha, Numérique, Date, Heure ou Booléen).

Dans d'autres cas (list box basées sur des sélections nommées, colonnes associées à des expressions), la fonction de tri standard n'est pas disponible. Un tri de list box standard modifie l'ordre de la sélection courante dans la base de données. Cependant, les enregistrements en surbrillance et l'enregistrement courant ne sont pas modifiés. Un tri standard synchronise toutes les colonnes de la list box, y compris les colonnes calculées.

Grammaire JSON

NomType de donnéesValeurs possibles
sortablebooleantrue, false

Objets pris en charge

List Box


Action standard

Activités typiques à réaliser par les objets actifs (par exemple, permettre à l'utilisateur d'accepter, d'annuler ou de supprimer des enregistrements, de se déplacer entre les enregistrements ou de page en page dans un formulaire multi-pages, etc.) ont été prédéfinies par 4D comme actions standard. Elles sont décrites en détail dans la section Actions standard du manuel de développement.

Vous pouvez associer à la fois une action standard et la méthode projet d'un objet. Dans ce cas, l'action standard est généralement exécutée après la méthode et 4D utilise cette action pour activer/désactiver l'objet en fonction du contexte courant. Lorsqu’un objet est désactivé, la méthode projet associée ne peut être exécutée.

Vous pouvez également définir cette propriété à l'aide de la commande OBJECT SET ACTION.

Grammaire JSON

NomType de donnéesValeurs possibles
actionstringLe nom d'une action standard valide.

Objets pris en charge

Bouton - Grille de boutons - Check Box - Liste déroulante - List Box - Bouton image - Pop-up Menu image - Onglet