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 v19
Formulaires dynamiques

Formulaires dynamiques  


 

Les Formulaires dynamiques sont des formulaires dont les structures sont définies dans un fichier .json ou dans un objet 4D. Ils sont régénérés chaque fois qu'ils sont exécutés et offrent un niveau élevé de flexibilité. Quelques-uns de leurs avantages notables sont : 

  • Utilisabilité
    • mises à jour simples
    • modifications dynamiques de l'utilisateur
    • réutilisation facile
    • recherche plus rapide
  • Portabilité
    • partage simplifié
    • peut être stocké dans un système de gestion de version (source control)

Chaque objet défini dans un un formulaire dynamique, y compris le formulaire lui-même, possède une ou plusieurs propriétés. Voir le Sommaire de la page pour une description rapide de ces propriétés.

Ce qui suit est un simple fichier JSON  ("HW.json", stocké dans le dossier Resources) avec du texte, une image et un bouton :

{
    "windowTitle": "Hello World",
    "windowMinWidth": 220,
    "windowMinHeight": 80,
    "method": "HWexample",
    "pages": [
        null,
        {
            "objects": {
                "text": {
                "type": "text",
                "text": "Hello World!",
                "textAlign": "center",
                "left": 50,
                "top": 120,
                "width": 120,
                "height": 80
                },
                "image": {
                "type": "picture",
                "pictureFormat": "scaled",
                "picture": "/RESOURCES/Images/HW.png",
                "alignment":"center", 
                "left": 70,
                "top": 20, 
                "width":75, 
                "height":75        
                },
                "button": {
                "type": "button",
                "text": "OK",
                "action": "Cancel",
                "left": 60,
                "top": 160,
                "width": 100,
                "height": 20
                }
            }
        }
    ]
}

Ce formulaire peut être chargé dans une boîte de dialogue avec le code 4D suivant :

 $fen:=Creer fenetre formulaire("/RESOURCES/HW.json")
 DIALOGUE("/RESOURCES/HW.json")
 FERMER FENETRE($fen)

Qui affiche le formulaire :

Lors de la création de formulaires à partir de fichier, ceux-ci doivent :

  • se conformer au schéma JSON. Le schéma JSON des formulaires 4D peut être trouvé dans le dossier de l'application 4D à l'adresse : Resources/formsSchema.json. Il est de votre responsabilité de vérifier la validité du fichier .json du formulaire. Voir la commande JSON Valider.
  • être des fichiers avec une extension ".json".
  • être stockés dans le répertoire de l'application, contenant le fichier de structure.

Note : Les commentaires dans les fichiers .json doivent être contenus dans la propriété "comments". Les caractères standards pour les commentaires (c'est-à-dire, "//", "/*", "'", etc.) rendront le fichier invalide.

Tous les chemins d'accès peuvent être relatifs ou absolus. Ils doivent utiliser '/' comme délimiteur et sont résolus de la façon suivante :

  • Un chemin relatif ne doit pas commencer par '/'. Il est résolu relativement au document JSON dans lequel se trouve la chaîne de chemin d'accès,
  • Un chemin absolu commence par '/'. Pour des raisons de sécurité, seul "/RESOURCES" est accepté comme chemin absolu et désigne le dossier de ressources de la base de données en cours. Par exemple, "/RESOURCES/templates/myfile.json" pointe vers le fichier  "myfile.json" situé dans le dossier des ressources de la base courante.

Notes :

  • La résolution du nom est sensible à la casse.
  • 4D ne résout pas le chemin vers un fichier . json situé sur le réseau (commençant par "http/https").
  • Si le chemin est incorrect ou si le fichier n'est pas valide conformément au schéma JSON, une erreur sera générée.
 
 

Les formulaires dynamiques peuvent contenir des pointeurs JSON. Les pointeurs JSON sont automatiquement résolus lorsque vous appelez une des commandes 4D qui acceptent un formulaire dynamique en paramètre (chemin fichier .json ou objet 4D) :

Pour plus d'informations sur les pointeurs JSON, veuillez vous reporter à la section Définition des pointeurs JSON.

Les propriétés énumérées dans cette section sont celles qui fournissent la base et la structure d'un formulaire.

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
inheritedFormchaîneDésigne le formulaire hérité.Nom (chaîne) de la table ou formulaire projet OU un chemin POSIX (chaîne) vers un fichier .json décrivant le formulaire OU un objet décrivant le formulaireformulaire
inheritedFormTabletableDésigne la table que le formulaire hérité utilisera.Un nom ou un numéro de tableformulaire
memorizeGeometrybooléenMémorise des paramètres du formulaire au moment de la fermeture de la fenêtre. Voir Mémorisation automatique des fenêtres et des valeursTRUE / FALSEformulaire
windowTitlechaîneUtilisé par la commande Creer fenetre formulaire pour le titre de la fenêtre.diversesformulaire
destinationchaîneType de formulaire."detailScreen", "listScreen", "detailPrinter", "listPrinter"formulaire
pagescollectionCollection de pages (chaque page est un objet)Objets pageformulaire
entryOrdercollectionCollection de noms d'objets formulaire définissant l'ordre d'entrée (l'ordre dans lequel les objets formulaire sont séquentiellement mis en évidence lorsque l'utilisateur appuie sur Tab ou Ctrl/Cmd+Tab). Si cette propriété n'est pas définie, l'ordre d'entrée par défaut (basé sur l'ordre de définition des objets de la page) est utilisé.Noms d'objets formulairePage formulaire
 
 
Taquets  

Les taquets spécifient des emplacements précis sur la règle verticale du formulaire. Utilisés principalement dans les formulaires de sortie, ils contrôlent les informations répertoriées et définissent les zones d'en-tête, de rupture, de corps ou de pied de page d'un formulaire.

 

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
markerBodyEntierPosition du taquet de corpsminimum : 0formulaire
markerBreakEntier/Tableau EntierPosition(s) des taquet(s) de ruptureminimum : 0formulaire
markerFooterEntierPosition du taquet de piedminimum : 0formulaire
markerHeaderEntier//Tableau EntierPosition(s) des taquet(s) d'en-têteminimum entier : 0 ; minimum Tableau Entier : 0formulaire

Objets  

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
memorizeValuebooléen Enregistre la valeur de l'objet en cours lorsque memorizeGeometry est activé pour le formulaire courant.TRUE / FALSEzone de saisie (input), onglet, case à cocher, bouton radio, pop up menu, séparateur, list box 
namechaîneLe nom de l'objet du formulaire (optionnel pour le formulaire)Tout nom qui n'appartient pas à un objet déjà existantformulaire,colonne de list box, en-tête de list box, pied de list box
textchaîneLe titre de l'objet du formulairediversestexte, zone de groupe, bouton, case à cocher, bouton radio, en-tête de list box
typechaîneObligatoire. Désigne le type de données de l'objet du formulaire."text", "rectangle", "groupBox", "tab", "line", "button", "checkbox", "radio", "dropdown", "combo", "webArea", "write", "subform", "plugin", "splitter", "buttonGrid", "progress", "ruler", "spinner", "stepper", "list", "pictureButton", "picturePopup", "listbox", "input", "view"texte, rectangle, zone de groupe, onglet, ligne, bouton, case à cocher, bouton radio, liste déroulante, combo box, zone web, zone 4D Write Pro, sous-formulaire, plug-in, séparateur, grille de boutons, thermomètre, règle, indicateur de progression asynchrone (spinner) , stepper, liste, bouton image, popup menu image, list box, zone de saisie (input), View Pro
variableCalculationchaînePermet d'effectuer des calculs mathématiques."none", "minimum", "maximum", "sum", "count", "average", "standardDeviation", "variance", "sumSquare" pied de list box
displaybooléenFALSE pour indiquer un objet invisible mais actifTRUE / FALSEbouton, liste déroulante
classchaîneNom CSSTout nom de style sheet existanttexte, rectangle, zone de groupe, onglet, ligne, bouton, case à cocher, bouton radio, liste déroulante, combo box, zone web, zone 4D Write Pro,sous-formulaire, plug-in, séparateur, grille de boutons, thermomètre, règle, indicateur de progression asynchrone (spinner) , stepper, liste, bouton image, popup menu image, list box, zone de saisie (input), View Pro
 
 
 
 

Un sous-formulaire est un formulaire inclut dans un autre formulaire.


PropriétéTypeDescriptionValeurs possiblesObjets Supportés
deletableInListbooléenPrécise si l'utilisateur peut supprimer des enregistrements dans une liste en sous-formulaire.TRUE / FALSE  sous-formulaire
detailFormchaîneNom d'un formulaire détaillé existant. Nom (chaîne) de la table ou du formulaire projet OU un chemin POSIX (chaîne) vers un fichier .json décrivant le formulaire OU un objet décrivant le formulairesous-formulaire, list box
doubleClickInEmptyAreaActionchaîneAction à effectuer en cas de double-clic sur une ligne vide du sous-formulaire."addSubrecord"sous-formulaire
doubleClickInRowActionchaîneAction à effectuer en cas de double-clic sur un enregistrement de sous-formulaire."editSubrecord", "displaySubrecord"sous-formulaire, list box
enterableInListbooléenIndique si l'utilisateur peut modifier les données des enregistrements directement dans la liste, sans avoir à utiliser le formulaire détaillé associéTRUE / FALSE  sous-formulaire
listFormchaîneUn formulaire liste existant dans lequel vous pouvez saisir, afficher et modifier les données d'autres tables.Nom (chaîne) de la table ou du formulaire projet OU un chemin POSIX (chaîne) vers un fichier .json décrivant le formulaire OU un objet décrivant le formulairesous-formulaire
selectionModechaîneDésigne les options permettant aux utilisateurs de sélectionner des enregistrements."multiple", "single", "none"sous-formulaire, list box 

Action  

Les propriétés d'action fournissent des instructions pour les actions à effectuer.

La propriété "events" accepte un tableau JSON (collection) de chaînes ou de nombres. Les événements peuvent être désignés par leur nom ou par leur numéro (cf. constantes des événements formulaire). Par exemple, "events": ["onLoad"]) ou "events": [1].


PropriétéTypeDescriptionValeurs possiblesObjets supportés
eventsTableau chaîne ou tableau numériqueEvénement(s) pour lesquel(s) déclencher une action.onActivate, onAfterEdit, onAfterKeystroke, onAfterSort, onAlternateClick, onBeforeDataEntry, onBeforeKeystroke, onBeginDragOver, onBeginURLLoading, onBoundVariableChange, onClick, onCloseBox, onCloseDetail, onCollapse, onColumnMove, onColumnResize, onDataChange, onDeactivate, onDeleteAction, onDisplayDetail, onDoubleClick, onDragOver, onDrop, onEndURLLoading, onExpand, onFooterClick, onGettingFocus, onHeader, onHeaderClick, onLoad, onLoadRecord, onLongClick, onLosingFocus, onMenuSelect, onMouseEnter, onMouseLeave, onMouseMove, onMouseUp, onOpenDetail, onOpenExternalLink, onOutsideCall, onPagechange, onPluginArea, onPrintingBreak, onPrintingDetail, onPrintingFooter, onResize, onRowMove, onScroll, onSelectionChange, onTimer, onUnload, onURLFiltering, onURLLoadingError, onURLResourceLoading, onValidate, onVPReady, onWindowOpeningDeniedonglet, zone de saisie (input), bouton, case à cocher, bouton radio, liste déroulante, combo box, zone web, zone 4D Write Pro, sous-formulaire, plug-in, séparateur, grille de boutons, thermomètre, règle, indicateur de progression asynchrone (spinner), stepper, liste, bouton image, popup menu image, zone 4D View Pro, list box, colonne de list box
Action  

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
actionchaîneAction à exécuter.Le nom d'une action standard valide. Voir Actions standard.bouton, case à cocher, bouton radio, bouton image, liste déroulante, popup menu image, grille de boutons, onglet, list box
continuousExecutionbooléenExécute ou non la méthode objet avec l’événement Sur données modifiées pendant que l’utilisateur change la valeur de la jauge.TRUE / FALSEthermomètre, règle, stepper
draggingchaîneActive la fonction Glisser."none", "custom", "automatic" (excluant liste, list box)plug-in, zone de saisie (input), liste, zone 4D Write Pro, list box
droppingchaîneActive la fonction Déposer."none", "custom", "automatic" (excluant liste, list box)plug-in, zone de saisie (input), liste, zone 4D Write Pro, list box
methodchaîneUn nom de méthode projet.Le nom d'une méthode projet existanteonglet, zone de saisie (input), bouton, case à cocher, bouton radio, liste déroulante, combo box, zone web, zone 4D Write Pro, sous-formulaire, plug-in, séparateur, grille de boutons, thermomètre, règle, indicateur de progression asynchrone (spinner), stepper, liste, bouton image, popup menu image, formulaire, list box, zone 4D View Pro, colonne de list box
movableRowsbooléenAutorise le déplacement des lignes pendant l'exécution.TRUE / FALSElist box
sortablebooléenPermet de trier les données de la colonne en cliquant sur l'en-tête. TRUE / FALSElist box

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
borderRadiusentierLa valeur du rayon d'arrondi pour les rectangles à coins arrondis.minimum:0rectangle arrondi
bottomentierPositionne un objet en bas (centré).minimum : 0texte, rectangle, zone de groupe, onglet, ligne, bouton, case à cocher, bouton radio, liste déroulante, combo box, zone web, zone zone 4D Write Pro, sous-formulaire, plug-in, séparateur, grille de boutons, thermomètre, règle, indicateur de progression asynchrone (spinner), stepper, liste, bouton image, popup menu image, list box, zone de saisie (input)
heightentierDésigne la taille verticale d'un objetminimum : 0texte, rectangle, zone de groupe, onglet, ligne, bouton, case à cocher, bouton radio, liste déroulante, combo box, zone web, zone 4D Write Pro, sous-formulaire, plug-in, séparateur, grille de boutons, thermomètre, règle, indicateur de progression asynchrone (spinner), stepper, liste, bouton image, popup menu image, list box, zone de saisie (input)
leftentierPlace un objet sur la gauche.minimum : 0texte, rectangle, zone de groupe, onglet, ligne, bouton, case à cocher, bouton radio, liste déroulante, combo box, zone web, zone 4D Write Pro, sous-formulaire, plug-in, séparateur, grille de boutons, thermomètre, règle, indicateur de progression asynchrone (spinner), stepper, liste, bouton image, popup menu image, list box, zone de saisie (input)
maxWidthentierDésigne la plus grande taille autorisée pour les colonnes de list box.minimum : 0colonne de list box
minWidthentierDésigne la plus petite taille autorisée pour les colonnes de list box.minimum : 0colonne de list box
rightentierPlace un objet sur la droite.minimum : 0texte, rectangle, zone de groupe, onglet, ligne, bouton, case à cocher, bouton radio, liste déroulante, combo box, zone web, zone 4D Write Pro, sous-formulaire, plug-in, séparateur, grille de boutons, thermomètre, règle, indicateur de progression asynchrone (spinner), stepper, liste, bouton image, popup menu image, list box, zone de saisie (input)
rowHeightchaîneDéfinit la hauteur des lignes de la list box.unités de valeurs css "em" ou "px" (défaut)list box
rowHeightAutobooléenActive ou désactive le redimensionnement automatique pour la hauteur des lignes d'une list box.TRUE / FALSElist box
rowHeightAutoMaxchaîneDésigne la plus grande hauteur autorisée pour les lignes d'une list box.unités de valeurs css "em" ou "px" (défaut). minimum : 0list box
rowHeightAutoMinchaîneDésigne la plus petite hauteur autorisée pour les lignes d'une list box.unités de valeurs css "em" ou "px" (défaut). minimum : 0list box
rowHeightSourcevariablesUn tableau définissant différentes hauteurs pour les lignes d'une list box.Nom d'un tableau 4Dlist box
startPointchaîneDésigne où une ligne commence."topLeft", "bottomLeft"ligne
topentierPlace un objet en haut (centré).minimum : 0texte, rectangle, zone de groupe, onglet, ligne, bouton, case à cocher, bouton radio, liste déroulante, combo box, zone web, zone 4D Write Pro, sous-formulaire, plug-in, séparateur, grille de bouton, thermomètre, règle, indicateur de progression asynchrone (spinner), stepper, liste, bouton image, popup menu image, list box, zone de saisie (input)
widthentierDésigne une taille horizontale d'objetsminimum : 0formulaire, texte, rectangle, zone de groupe, onglet, ligne, bouton, case à cocher, bouton radio, liste déroulante, combo box, zone web, zone 4D Write Pro, sous-formulaire, plug-in, séparateur, grille de boutons, thermomètre, règle, indicateur de progression asynchrone (spinner), stepper, liste, bouton image, popup menu image, list box, zone de saisie (input)

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
bottomMarginentierValeur de la marge verticale (en pixels).minimum : 0formulaire
rightMarginentierValeur de la marge horizontale (en pixels).minimum : 0formulaire
formSizeAnchorchaîneNom de l'objet dont la position détermine la taille du formulaire (taille minimale : 1).Nom d'objet du formulaireformulaire
windowMaxHeightentierDésigne la plus grande hauteur autoriséee.minimum : 0formulaire
windowMaxWidthentierDésigne la plus grande largeur autorisée.minimum : 0 formulaire
windowMinHeightentierDésigne la plus petite hauteur permise.minimum : 0 formulaire
windowMinWidthentierDésigne la plus petite largeur permise.minimum : 0 formulaire
windowSizingXchaîneIndique si l'utilisateur peut redimensionner le formulaire verticalement."fixed", "variable"formulaire
windowSizingYchaîneIndique si l'utilisateur peut redimensionner le formulaire horizontalement."fixed", "variable"formulaire

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
resizablebooléenIndique si la taille d'un objet peut être modifiée par l'utilsateur.TRUE / FALSEcolonnes list box
sizingXchaîneIndique si la taille horizontale de l'objet doit être déplacée ou redimensionnée lorsqu'un utilisateur redimensionne le formulair."move","grow","fixed"formulaire, texte, rectangle, zone de groupe, onglet, ligne, bouton, case à cocher, bouton radio, liste déroulante, combo box, zone web, zone 4D Write Pro, sous-formulaire, plug-in, séparateur, grille de boutons, thermomètre, règle, indicateur de progression asynchrone (spinner), stepper, liste, bouton image, popup menu image, list box, zone de saisie (input)
sizingYchaîneIndique si la taille verticale de l'objet doit être déplacée ou redimensionnée lorsqu'un utilisateur redimensionne le formulaire."move","grow","fixed"formulaire, texte, rectangle, zone de groupe, onglet, ligne, bouton, case à cocher, bouton radio, liste déroulante, combo box, zone web, zone 4D Write Pro, sous-formulaire, plug-in, séparateur, grille de boutons, thermomètre, règle, indicateur de progression asynchrone (spinner), stepper, liste, bouton image, popup menu image, list box, zone de saisie (input)
splitterModechaîneLorsqu'un séparateur a cette propriété, les autres objets à sa droite (séparateur vertical) ou en dessous (séparateur horizontal) sont poussé en même temps que le séparateur, sans arrêt. "resize", "move"séparateur

Valeur  

PropritéTypeDescriptionValeurs possiblesObjets Supportés
automaticInsertionbooléenPermet d'ajouter automatiquement une valeur à une liste stockée en mémoire lorsqu'un utilisateur saisie une valeur qui ne se trouve pas dans l'énumération associée à l'objet. TRUE / FALSEcombo box, colonne de list box
choiceListlisteAssocie une énumération à une colonne de list box. diverseszone de saisie (input), liste déroulante, combo box, colonne de list box
currentItemSourcechaîneLe dernier élément sélectionné.Expression objetlist box
currentItemPositionSourcechaînePosition du dernier élément sélectionné.Expression  numériquelist box
dataSourcechaîne, ou tableau texte pour une colonne de list box hiérarchiqueUne variable 4D, un nom de champ ou une expression 4D validediversesonglet, zone de saisie (input), bouton, case à cocher, bouton radio, liste déroulante, combo box, zone 4D Write Pro, sous-formulaire, plug-in, séparateur, grille de bouton, thermomètre, règle, indicateur de progression asynchrone (spinner), stepper, liste, bouton image, popup menu image, colonne de list box, en-tête de list box, pied de list box, list box, zone 4D View Pro
dataSourceTypeHintchaîneIndique le type de la variable de formulaire"integer", "number", "boolean", "picture", "text", date", "time", "arrayText", "object", "collection", "undefined"onglet, zone de saisie (input), bouton, case à cocher, bouton radio, liste déroulante, combo box, zone 4D Write Pro, sous-formulaire, plug-in, séparateur, grille de boutons, thermomètre, règle, indicateur de progression asynchrone (spinner), stepper, liste, list box, colonne de list box, pied de listbox
labelslisteAssocie des valeurs par défaut ou une liste de choix à une colonne de list boxx.diversesonglet
listlisteListe associée à un objet formulaire liste hiérarchique.diversesliste
listboxTypechaînePrécise le comportement de la list box (type)."array", "currentSelection", "namedSelection", "collection"(*)list box
saveAschaîneIndique si c'est la valeur ou la référence de l'élément qui doit être récupéré lorsque l'élément est cliqué dans une liste."value"; "reference"liste déroulante, colonne de list box
selectionNamechaîneLe contenu de la list box sera basé sur la sélection temporaire spécifiée.nom de la sélection temporairelist box
selectedItemsSourcechaîneCollection d'éléments sélectionnés.Expression collectionlist box
tablechaîne/entierPermet de spécifier la source de données pour un sous-formulaire ou une list box.Noms de tables existants (sans "[" "]" ou ID de table (entier minimum : 0)sous-formulaire, list box

(*) "collection" désigne une list box basée sur une collection ou une sélection d'entités (entity selection).

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
booleanFormatchaîneSpécifie seulement deux valeurs possibles."TRUE"; "FALSE"zone de saisie (input), colonne de list box
controlTypechaîneSpécifie le rendu de la valeur dans une cellule de list box."input", "checkbox" (pour les colonnes booléennes / numériques), "automatic", "popup" (seulement pour les colonnes booléennes)colonne de list box
dateFormatchaîneContrôle la façon dont les dates apparaissent lorsqu'elles sont affichées ou imprimées. Doit être sélectionné uniquement parmi les formats internes de 4D."systemShort", "systemMedium", "systemLong", "iso8601", "rfc822", "short", "shortCentury", "abbreviated", "long", "blankIfNull" (peut être combiné avec les autres valeurs possibles).zone de saisie (input), colonne de list box, liste déroulante, combo box, pied de list box
numberFormatchaîneContrôle la façon dont les chiffres apparaissent lorsqu'ils sont affichés ou imprimés.nombres (incluant un séparateur décimal ou un signe moins si nécessaire)zone de saisie (input), liste déroulante, combo box, règle, thermomètre, colonne de list box, pied de list box
pictureFormatchaîneContrôle la façon dont les images apparaissent lorsqu'elles sont affichées ou imprimées. "truncatedTopLeft", "scaled", "truncatedCenter", "tiled" (images seulement), "proportionalTopLeft" (excluant les images), "proportionalCenter"(excluant les images)image, zone de saisie (input), list box, pied de list box
textFormatchaîneContrôle la manière dont les champs et variables alphanumériques apparaissent lorsqu'ils sont affichés ou imprimés."### ####", "(###) ### ####", "### ### ####", "### ## ####", "00000", formats personnalisészone de saisie (input), combo box, liste déroulante, colonne de list box, pied de list box
timeFormatchaîneContrôle la façon dont les heures apparaissent lorsqu'elles sont affichées ou imprimées. Doit être sélectionné uniquement parmi les formats intégrés de 4D."systemShort", "systemMedium", "systemLong", "iso8601", "hh_mm_ss", "hh_mm", "hh_mm_am", "mm_ss", "HH_MM_SS", "HH_MM", "MM_SS", "blankIfNull" (peut être combiné avec les autres valeurs possibles) zone de saisie (input), liste déroulante, colonne de list box, pied de list box
truncateModechaîneContrôle l'affichage des valeurs lorsque les colonnes de la list box sont trop étroites pour afficher leur contenu complet."withEllipsis"; "none"colonne de list box, pied de list box
visibilitychaînePermet de masquer l'objet dans le mode Application."visible", "hidden", "selectedRows", "unselectedRows"commun, colonne de list box
Saisie  

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
contextMenuchaînePermet à l'utilisateur d'accéder à un menu contextuel standard dans la zone sélectionnée."automatic", "none"zone de saisie (input), zone web, zone 4D Write Pro, colonne de list box
enterablebooléenAutorise la saisie.TRUE / FALSEzone de saisie (input), colonne de list box, liste, stepper, règle, thermomètre, zone 4D Write Pro
entryFilterchaîneAssocie un filtre de saisie à un objet ou des cellules de list box. Cette propriété n'est pas accessible si la propriété Saisissable n'est pas activée.diverseszone de saisie (input), combo box, liset, colonne de list box
focusablebooléenPermet à l'objet d'avoir le focus (et peut être activé par le clavier).TRUE / FALSEzone de saisie (input), bouton, case à cocher, bouton radio, liste déroulante, zone 4D Write Pro, sous-formulaire, plug-in, règle, liste, list box
keyboardDialectchaîneAssocie une configuration du clavier spécifique à un champ ou un objet saisissable en utilisant les identifiants de langage RFC 3066 Bis.diverseszone de saisie (input), 4D Write Pro
multilinechaîneIndique si un texte trop long pour être affiché sera tronqué (avec ou sans des retours ligne)."automatic", "yes", "no"zone de saisie (input)
placeholderchaîneTexte à afficher (grisé) lorsque la valeur de la source de données est vide.diverseszone de saisie (input), combo box
shortcutAccelbooléenSpécifie le système à utiliser, Windows ou Mac.TRUE / FALSEcase à cocher, bouton radio, bouton image
shortcutAltbooléenDésigne la touche AltTRUE / FALSEcase à cocher, bouton radio, bouton image
shortcutCommandbooléenDésigne la touche Commande (Mac)TRUE / FALSEcase à cocher, bouton radio, bouton image
shortcutControlbooléenDésigne la touche Contrôle (Windows)TRUE / FALSEcase à cocher, bouton radio, bouton image
shortcutKeychaîneLa lettre ou le nom d'une touche spéciale."[F1]" -> "[F15]", "[Return]", "[Enter]", "[Backspace]", "[Tab]", "[Esc]", "[Del]", "[Home]", "[End]", "[Help]", "[Page up]", "[Page down]", "[left arrow]", "[right arrow]", "[up arrow]", "[down arrow]"case à cocher, bouton radio, bouton image
shortcutShiftbooléenDésigne la touche Maj (Shift)TRUE / FALSEcase à cocher, bouton radio, bouton image
showSelectionbooléenMaintient la sélection visible dans l'objet après qu'il ait perdu le focus.TRUE / FALSEzone de saisie (input),  zone 4D Write Pro
singleClickEditbooléenPermet le passage direct en mode d'édition.TRUE / FALSElist box
spellcheckbooléenIndique si l'orthographe sera vérifiée automatiquement ou non.TRUE / FALSEzone de saisie (input),  zone 4D Write Pro

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
excludedListlistePermet de spécifier une énumération dont les valeurs ne peuvent pas être saisies. Si une valeur exclue est saisie, elle n'est pas acceptée et un message d'erreur est affiché. diverseszone de saisie (input), combo box, colonne de list box
maxchaîne / nombreValeur maximale autorisée. Pour les steppers, ces propriétés représentent des secondes lorsque l'objet est associé à une valeur de type heure, et sont ignorées lorsqu'il est associé à une valeur de type date.diverseszone de saisie (input), thermomètre, règle, stepper
minchaîne / nombreValeur minimale autorisée. Pour les steppers, ces propriétés représentent des secondes lorsque l'objet est associé à une valeur de type heure, et sont ignorées lorsqu'il est associé à une valeur de type date.diverseszone de saisie (input), thermomètre, règle, stepper
requiredListlistePermet de spécifier une énumération dont seules les valeurs peuvent être insérées.diverseszone de saisie (input), colonne de listbox

Aspect  

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
defaultButtonbooléenSimilaire à un bouton standard sauf qu'il a une apparence modifiée, destinée à indiquer le choix recommandé à l'utilisateur.TRUE / FALSEbouton
dpichaîneDéfinit la résolution d'écran pour le contenu de la zone 4D Write Pro.0, 72, 96zone 4D Write Pro
hideFocusRingbooléenDurant l'exécution, un champ ou un objet pouvant être saisi est délimité par un rectangle de sélection lorsqu'il a le focus. Vous pouvez masquer ce rectangle avec cette option. TRUE / FALSEzone de saisie (input), zone 4D Write Pro, sous-formulaire, liste, list box
hideSystemHighlightbooléenCette propriété est ajoutée pour les list box de type sélection uniquement. Elle est utilisée pour spécifier le masquage des enregistrements en surbrillance dans la list box.TRUE / FALSElist box
labelsPlacementchaîneSpécifie l'emplacement du libellé d'un objet."none", "top", "bottom", "left", "right"onglet, thermomètre, règle
layoutModechaîneDéfinit le mode d'affichage du document 4D Write Pro sur le formulaire.  "embedded, "draft", "page"zone 4D Write Pro
scrollbarHorizontalchaîneOutil permettant à l'utilisateur de déplacer la zone d'affichage vers la gauche ou la droite."visible", "hidden", "automatic"zone de saisie (input), zone 4D Write Pro, sous-formulaire, liste, listbox
scrollbarVerticalchaîneOutil permettant à l'utilisateur de déplacer la zone d'affichage vers le haut ou vers le bas."visible", "hidden", "automatic"zone de saisie (input), zone 4D Write Pro, sous-formulaire, liste, listbox
showBackgroundbooléenAffiche / masque les images d'arrière-plan et la couleur d'arrière-plan (affichées par défaut).TRUE / FALSEzone 4D Write Pro
showHeadersbooléenActive ou désactive la visibilité des en-têtes du document ou de la list box.TRUE / FALSEzone 4D Write Pro, list box
showHiddenCharsbooléenAffiche / cache les caractères invisibles (masqués par défaut).TRUE / FALSEzone 4D Write Pro
showHorizontalRulerbooléenAffiche / masque la règle horizontale (affichée par défaut). TRUE / FALSEzone 4D Write Pro
showVerticalRulerbooléenAffiche / masque la règle verticale (affichée par défaut). TRUE / FALSEzone 4D Write Pro
showHTMLWysiwygbooléenActive / désactive la vue HTML WYSIWYG, dans laquelle tous les attributs avancés de 4D Write Pro qui ne sont pas compatibles avec tous les navigateurs sont supprimés (désactivée par défaut). TRUE / FALSEzone 4D Write Pro
showFootersbooléenActive ou désactive la visibilité des pieds du document ou de la list box.TRUE / FALSEzone 4D Write Pro, list box
showPageFramesbooléenActive / masque le cadre de la page lorsque le mode d'affichage est réglé sur "Page". Par défaut, le cadre est caché.TRUE / FALSEzone 4D Write Pro
showReferencesbooléenAffiche toutes les expressions 4D insérées dans le document en tant que références.TRUE / FALSEzone 4D Write Pro
userInterfacechaîneActive / masque l'interface utilisateur 4D View Pro."ribbon", "toolbar", "none" (valeur par défaut)View Pro
withFormulaBarbooléenActive / masque la barre de formule 4D View Pro. À utiliser uniquement avec l'interface ToolbarTRUE / FALSE (valeur par défaut)View Pro
zoomchaîneDéfinit le pourcentage de zoom pour l'affichage du contenu de la zone 4D Write Pro. La valeur par défaut est 100%.25, 50, 75, 100, 125, 150, 175, 200, 300, 400zone 4D Write Pro

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
alternateFillcouleurPermet de définir une couleur d'arrière-plan différente pour les lignes / colonnes impaires dans la list box. toute valeur css ; "transparent"; "automatic"list box, colonne de list box
borderStylechaînePermet de définir un style standard pour la bordure de l'objet list box. "system", "none", "solid", "dotted", "raised", "sunken", "double"texte, zone de saisie (input), zone web, zone 4D Write Pro, sous-formulaire, plug-in, séparateur, grille de boutons, thermomètre, règle, indicateur de progression asynchrone (spinner), stepper, liste, bouton, bouton image, popup menu image, list box
fillcouleurDéfinit la couleur d'arrière-plan d'un objet.toute valeur css ; "transparent"; "automatic"texte, rectangle, ovale, zone de saisie (input), liste, list box
hideExtraBlankRowsbooléenDésactive la visibilité des lignes vides supplémentaires.TRUE / FALSElist box
rowFillSourcediversesNom d'un tableau ou d'une expression permettant d'appliquer une couleur d'arrière-plan personnalisée à chaque ligne de la list box. couleurs RGBlist box, colonne de list box
strokeDashArraytableau numérique ou texteDéfinit les valeurs pour chaque ligne d'un objet. Ex. "6 1" ou [6,1]diversesligne, rectangle, ovale
strokeWidthentierDésigne l'épaisseur d'une ligne.entier ou 0 pour la plus petite largeur sur un formulaire impriméligne, rectangle, ovale

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
printFramechaîneGère le mode d'impression pour les objets dont la taille peut varier d'un enregistrement à l'autre en fonction de leur contenu. "fixed", "fixedMultiple", "variable"sous-formulaire, zone de saisie (input), zone 4D Write Pro

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
allowFontColorPickerbooléenPermet à l'utilisateur de modifier la police ou la couleur de l'objet pour la session en cours.TRUE / FALSEzone de saisie, list box
customBackgroundPictureimageDéfinit l'image qui sera affichée en arrière-plan du bouton.Chemin d'accès "sandboxed", absolu ou relatif. Doit être utilisé avec la propriété style avec l'option "custom".bouton, case à cocher, bouton radio
customBorderXentierDéfinit la taille (en pixels) des marges horizontales internes d'un objet. Doit être utilisé avec la propriété style avec l'option "custom".diversesbouton, case à cocher, bouton radio
customBorderYentierDéfinit la taille (en pixels) des marges verticales internes d'un objet. Doit être utilisé avec la propriété style avec l'option "custom".diversesbouton, case à cocher, bouton radio
customOffsetentierDéfinit une valeur d'offset personnalisée en pixels. Doit être utilisé avec la propriété style avec l'option "custom".diversesbouton, case à cocher, bouton radio
fontFamilychaîneNom de la police utilisée sur l'objet.diversestexte, zone de groupe, onglet, zone de saisie (input), bouton, case à cocher, bouton radio, liste déroulante, combo box, thermomètre, règle, liste, list box
fontSize entierTaille de la police en points.minimum : 0texte, zone de groupe, onglet, zone de saisie (input), bouton, case à cocher, bouton radio, liste déroulante, combo box, thermomètre, règle, liste, list box
fontStylechaîneDéfinit l'inclinaison du texte sélectionné."normal", "italic"texte, zone de groupe, onglet, zone de saisie (input), bouton, case à cocher, bouton radio, liste déroulante, combo box, thermomètre, règle, liste, list box
fontThemechaîneDésigne un style pour le texte de l'objet."normal", "main", "additional"texte, zone de saisie (input)
fontWeightchaîneDéfinit la graisse du texte sélectionné"normal", "bold"texte, zone de groupe, onglet, zone de saisie (input), bouton, case à cocher, bouton radio, liste déroulante, combo box, thermomètre, règle, liste, list box
metaSourcechaîneUn objet meta contenant des paramètres de style et de sélection.Expression objetList box
rowStrokeSourcechaîneNom d'un tableau ou expression pour gérer les couleurs des lignes.diverseslist box, colonne de list box
rowStyleSourcechaîneNom d'un tableau ou expression pour gérer les styles des lignesdiverseslist box, colonne de list box
storeDefaultStylebooléenStocke les balises de style avec le texte. Doit être utilisé avec la propriété multistyle.TRUE / FALSEzone de saisie (input)
strokecouleurCouleur de la police utilisée dans l'obje.Toute valeur css, "transparent", "automatic"texte, rectangle, ovale, zone de saisie (input), bouton, case à cocher, bouton radio, liste, list box, colonne de list box, en-tête de list box, pied de list box
styledTextbooléenApplique des styles personnalisés à des zones de texte dynamiques (champs ou variables) dans l'environnement Appliquation. TRUE / FALSEzone de saisie (input)
textAlignchaîneEmplacement horizontal du texte dans la zone qui le contient."automatic", "right", "center", "justify", "left"texte, zone de groupe, zone de saisie (input), list box
textAnglechaîneModifie l'orientation (rotation) de la zone de texte.0, 90, 180, 270 texte, zone de saisie (input)
textDecorationchaîneActive ou inactive le soulignement."normal", "underline"texte, zone de groupe, onglet, zone de saisie (input), bouton, case à cocher, bouton radio, liste déroulante, combo box, thermomètre, règle, liste, list box
verticalAlignchaîneEmplacement vertical du texte dans la zone qui le contient."automatic", "top", "middle", "bottom"list box, colonne de list box, en-tête de list box, pied de list box
wordwrapchaîneGère l'affichage du contenu lorsqu'il dépasse la largeur de l'objet."automatic" (excluant la list box), "normal", "none"zone de saisie (input), colonne de  list box, pied de list box
 
 

The properties listed below are specific to the designated objects.

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
frameDelayentierPermet de parcourir le contenu du bouton image à la vitesse spécifiée (en ticks). minimum : 0bouton image
loopBackToFirstFramebooléenLes images sont affichées dans une boucle continue. TRUE / FALSEbouton image
switchBackWhenReleasedbooléenAffiche la première image tout le temps sauf lorsque l'utilisateur clique sur le bouton. Affiche la seconde image jusqu'à ce que le bouton de la souris soit relâché.TRUE / FALSEbouton image
switchContinuouslybooléenPermet à l'utilisateur de maintenir le bouton de la souris enfoncé pour afficher les images en continu (c'est-à-dire en tant qu'animation). TRUE / FALSEbouton image
switchWhenRolloverbooléenModifie le contenu du bouton image lorsque le curseur de la souris passe dessus. L'image initiale est affichée lorsque le curseur quitte la zone du bouton. TRUE / FALSEbouton image
useLastFrameAsDisabledbooléenPermet de définir la dernière image comme étant celle à afficher lorsque le bouton est désactivé.TRUE / FALSEbouton image

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
columnCountentierIndique le nombre de colonnes dans une série de vignettes.minimum : 1grille de boutons, bouton image, popup menu image
popupPlacementchaînePermet d'afficher un symbole qui apparaît sous la forme d'un triangle dans le bouton, ce qui indique qu'un menu contextuel est joint. "none", "linked", "separated"bouton
radioGroupchaînePermet d'utiliser des boutons radio dans des ensembles coordonnés : un seul bouton à la fois peut être sélectionné dans un groupe. Nom du groupe des boutons radiobouton radio
rowCountentierDéfinit le nombre de lignes dans une série de vignettes.minimum : 1grille de boutons, bouton image, popup menu image
stylechaînePermet de définir l'apparence générale du bouton. Voir Style de bouton pour plus d'informations."regular", "toolbar", "bevel", "roundedBevel", "gradientBevel", "texturedBevel", "office", "help", "circular", "disclosure", "roundedDisclosure", "custom", "flat"bouton, case à cocher, bouton radio
textPlacementchaînePermet de modifier l'emplacement relatif du titre par rapport à l'objet associé. Aucun effet si l'objet contient uniquement un titre (aucune image associée) ou une image (aucun titre). "left", "right", "top", "bottom", "center"bouton, case à cocher, bouton radio
threeStatebooléenPermet à une case à cocher d'accepter un troisième état.TRUE / FALSEcase à cocher

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
graduationStepentierMesure d'affichage d'échelle.diversesindicateurs de progression, règle
stepentierIntervalle minimum accepté entre les valeurs pendant l'utilisation. Pour les steppers numériques, cette propriété représente des secondes lorsque l'objet est associé à une valeur de type heure, et des jours lorsque l'objet est associé à une valeur de type date.diversesindicateurs de progression, règle, stepper
showGraduationsbooléenAffiche / masque les graduations à côté des étiquettes.TRUE / FALSEindicateurs de progression, règle
Aide  

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
tooltipchaîneFournit aux utilisateurs des informations supplémentaires sur un champ.diversesonglet, zone de saisie (input), bouton, case à cocher, bouton radio, liste déroulante, combo box, séparateur, grille de boutons, thermomètre, règle, indicateur de progression asynchrone (spinner), stepper, liste, bouton image, popup menu image, en-tête de list box, pied de list box

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
columnstableau de colonnesContient les attributs des colonnes de list box.diverseslist box
highlightSetchaîneSpécifie l'ensemble à utiliser pour gérer les enregistrements en surbrillance dans la list box (lorsque la source de données Tableaux est sélectionnée, un tableau booléen avec le même nom que la list box est utilisé).diverseslist box
lockedColumnCountentierNombre de colonnes qui doivent rester affichées en permanence dans la partie gauche de la list box, même lorsque l'utilisateur fait défiler les colonnes horizontalement.minimum : 0list box
staticColumnCountentierNombre de colonnes qui ne peuvent pas être déplacées pendant l'exécution.minimum : 0list box

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
horizontalLineStrokecouleurDéfinit la couleur des lignes horizontales dans la list box (gris par défaut). toute valeur css, "'transparent", "automatic"list box
verticalLineStrokecouleurDéfinit la couleur des lignes verticales dans la list box (gris par défaut).toute valeur css, "'transparent", "automatic"list box

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
footerobjetDésigne un objet situé en bas et séparé du corps principal de la list box.diversescolonne de list box
footerHeightchaînePermet de définir la hauteur d'un pied de liste. Vous pouvez définir l'unité (lignes ou pixels).pattern ^(\\d+)(px|em)?$ (positive decimal + px/em )list box
headerobjetDésigne un objet devant être en haut et séparé du corps principal de la list box.diversescolonne de list box
headerHeightchaîneUtilisé pour définir la hauteur d'un en-tête de list box. Vous pouvez définir l'unité (lignes ou pixels).pattern ^(\\d+)(px|em)?$ (positive decimal + px/em )list box
showFootersbooléenPermet d'afficher ou de masquer les pieds du document ou des colonnes.TRUE / FALSEzone 4D Write Pro, list box
showHeadersbooléenPermet d'afficher ou de masquer les en-têtes de colonnes.TRUE / FALSEzone 4D Write Pro, list box
Image  

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
iconimageLe nom, le numéro ou le chemin d'accès de l'image.chemin d'accès "sandboxed" absolu ou relatifen-tête de list box, bouton, case à cocher
iconFramesentierDéfinit le nombre exact d'états présents dans l'image.minimum : 1bouton, case à cocher, bouton radio
iconPlacementchaîneDésigne le placement d'un icône par rapport à l'objet sur le formulaire."none", "left", "right"en-tête de list box
Plug-in  

PropriétéTypeDescriptionValeurs possiblesObjets pris en charge
pluginAreaKindchaîneDécrit le type de plug-in.varientplug-in 
customPropertieschaîne/objetPropriétés spécifiques du plug-in, passées au plug-in sous forme de chaîne JSON s'il s'agit d'un objet, ou sous forme de buffer binaire s'il s'agit d'une chaîne de base64 codéevarientplug-in

PropriétéTypeDescriptionValeurs possiblesObjets Supportés
methodsAccessibilitychaîneInstancie un objet JavaScript spécial ($4d) pour gérer les appels aux méthodes projet de 4D. Doit être utilisé avec la propriété webEngine."all", "none"zone web
progressSourcechaîneValeur comprise entre 0 et 100, représentant le pourcentage d'achèvement de chargement de page dans la zone Web. Mis à jour automatiquement par 4D, ne peut pas être modifié manuellement. diverseszone web
urlSourcechaîneDésigne l'URL chargée ou en cours de chargement par la zone web associée.diverseszone web
webEnginechaînePermet de choisir entre deux moteurs de rendu pour la zone Web, en fonction des spécificités de l'application."embedded", "system"zone web

Ces propriétés stockent les informations de configuration du formulaire.

PropriétéTypeDescriptionValeurs possiblesObjets pris en charge
paperNamechaîneNom du format du document"A4", "Lettre US"...formulaire 
paperWidthchaîneUtilisé si un document nommé paperName n'a pas été trouvé. Requiert un suffixe d'unité : pt, in, mm, cm.ex : "210mm"formulaire 
paperHeightchaîneUtilisé si un document nommé paperName n'a pas été trouvé. Requiert un suffixe d'unité : pt, in, mm, cm.ex: "297mm"formulaire 
orientationchaîneOrientation du document"paysage" (par défaut "portrait")formulaire 
scalenumériquePourcentage de mise à l'échelle du document (100 signifie qu'il n'y a pas de zoom)minimum: 0formulaire



Voir aussi  

Vue d'ensemble

 
PROPRIÉTÉS 

Produit : 4D
Thème : Construction des formulaires
Nom intl. : Dynamic Forms

 
PAGE CONTENTS 
 
HISTORIQUE 

Créé : 4D v16 R6

 
UTILISATION DE L'ARTICLE

4D - Mode Développement ( 4D v19)