Fond et bordure
Couleur de fond alternée
Permet de définir une couleur d'arrière-plan différente pour les lignes / colonnes impaires dans une list box. By default, Automatic is selected for list box columns: the column uses the alternate background color set at the list box level.
Vous pouvez également définir cette propriété à l'aide de la commande OBJECT SET RGB COLORS.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| alternateFill | string | toutes les valeurs css; "transparent"; "automatic"; "automaticAlternate" |
Objets pris en charge
List Box - Colonne de List Box
Commandes
OBJECT GET RGB COLORS - OBJECT SET RGB COLORS
Couleur de fond
Définit la couleur de fond / couleur de remplissage d'un objet. Elle peut être définie pour certains objets standard (propriété JSON fill) ou pour des objets de style "Custom" (propriété JSON borderFillColor).
La propriété Couleur de fond est parfois appelée Couleur d'arrière-plan notamment pour les objets List box, Colonne de List box et Pied de List box.
Objets standard
In the case of a list box column, by default Automatic is selected: the column uses the background color set at the list box level.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| fill | string | une valeur css; "transparent"; "automatic" |
Objets pris en charge
Hierarchical List - Input - List Box - List Box Column - List Box Footer - Oval - Rectangle - Text Area
Commandes
LISTBOX Get row color - LISTBOX SET ROW COLOR - OBJECT GET RGB COLORS - OBJECT SET RGB COLORS
Bouton personnalisé, case à cocher personnalisée ou bouton radio personnalisé
Cette propriété vous permet d'attribuer une couleur de fond aux boutons personnalisés, aux cases à cocher personnalisées ou aux boutons radio personnalisés. De plus, les boutons personnalisés doivent avoir le style de bordure "personnalisé". Dans les autres contextes, cette propriété n'est pas prise en compte.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| borderFillColor | string | une valeur css; "transparent"; "automatic" |
Objets pris en charge
Bouton personnalisé (avec le style de bordure "Personnalisé") - Case à cocher personnalisée - Bouton radio personnalisé
Commandes
OBJECT GET RGB COLORS - OBJECT SET RGB COLORS
Voir également
Expression couleur de fond
List box de type collection et entity selection
Une expression ou une variable (les variables de tableau ne peuvent pas être utilisées) pour appliquer une couleur d'arrière-plan personnalisée à chaque ligne de la list box. L'expression ou la variable sera évaluée pour chaque ligne affichée et doit retourner une valeur de couleur RGB. Pour plus d'informations, reportez-vous à la description de la commande OBJECT SET RGB COLORS.
Vous pouvez également définir cette propriété en utilisant la commande LISTBOX SET PROPERTY avec la constante lk background color expression.
Avec les list box de type collection ou sélection d'entité, cette propriété peut également être définie à l'aide d'une Meta Info Expression.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| rowFillSource | string | Une expression retournant une valeur de couleur RGB |
Objets pris en charge
List Box - Colonne de List Box
Commandes
LISTBOX Get property - LISTBOX SET PROPERTY
Couleur de bordure
Allows defining the border color. The effect of this property varies slightly depending on the type of object to which it is applied.
-
objects with text properties: buttons (all styles except "custom", see below), hierarchical lists, inputs, list boxes, progress indicators, rulers, and text areas.
By default, the border color of these objects is automatically set to their font color property. This default configuration corresponds to the Same as font option in the Property List (borderColorproperty is undefined in JSON).
You can separate these two properties by setting a color value for the object's "Border color" property (only available when the border line style property is plain (solidin JSON property) or dotted). -
objects without text properties: 4D View Pro areas, 4D Write Pro areas, button grids, picture buttons, picture pop-up menus, plug-in areas, subforms, spinners, splitters, steppers, web areas.
The border color property sets the color of the borders. The default color value is "Automatic", i.e. the border is displayed with the automatic color set by your OS. -
custom-styled buttons: custom buttons with "custom" Border Line Style, custom check boxes, and custom radio buttons.
In this case, the border color property defines the color of an inner border, which is an attribute of the object itself ans not a decoration property. This inner border can also have a width (it is displayed only if the width > 0).
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| borderColor | string | une valeur css; "transparent"; "automatic" |
Objets pris en charge
4D View Pro area - 4D Write Pro area - Button - Button Grid - Check Box ("custom" style) - Hierarchical List - Input - List Box - Picture Button - Picture Pop-up Menu - Plug-in Area - Progress Indicator - Radio Button ("custom" style) - Ruler - Text Area - Spinner - Splitter - Stepper - Subform - Web Area
Commandes
OBJECT GET RGB COLORS - OBJECT SET RGB COLORS
Voir également
Line Color (for shapes)
Style de la bordure
Allows setting a style for the object border. The following choices are available (all choices are not possible depending on the object):
| Style | Objects (*) | Description |
|---|---|---|
| Aucun | all | Objects appear with no border. |
| Plain | all | Objects appear framed with a continuous 1-pt. border line. ("solid" json value) |
| Dotted | all | Objects appear framed with a dotted 1-pt. border line. |
| Raised | all | Objects appear framed with a 3D effect. |
| Sunken | all | Objects appear framed with a sunken 3D effect. |
| Double | all | Objects appear framed with a double line, i.e., two continuous 1-pt. lines separated by a pixel. |
| System | all except buttons and text areas | Objects appear with a border line based on the graphic specifications of the OS. |
| System rounded | inputs | On macOS, objects appear with a native "Liquid Glass" system border effect (for information about Liquid Glass, see this 4D blog post). It includes system-defined inner border, corner radius, grey border color, and inner padding. Note that the "Liquid Glass" appearance is not used in a multiline input object if the scroll bars property is enabled ("System" is used in this case). On Windows, this style is similar to "System" at runtime. |
| Personnalisé | custom buttons | Enables the inner border design, that includes a set of extra properties: Fill color, Border color, Border width, and Corner radius. |
(*) "all" means "all objects supported" listed below.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| borderStyle | text | "custom", "dotted", "double", "none", "raised", "solid", "sunken", "system", "systemRounded" |
Objets pris en charge
4D View Pro Area - 4D Write Pro areas - Buttons - Button Grid - Hierarchical List - Input - List Box - Picture Button - Picture Pop-up Menu - Plug-in Area - Progress Indicator - Ruler - Spinner - Stepper - Subform - Text Area - Web Area
Commandes
OBJECT Get border style - OBJECT SET BORDER STYLE
Voir également
Dotted Line Type (shapes)
Largeur de bordure
Permet de définir la largeur de la bordure intérieure pour :
- les boutons personnalisés avec le style de bordure "personnalisé",
- les cases à cocher personnalisées,
- les boutons radio personnalisés.
Dans les autres contextes, cette propriété n'est pas prise en compte.
La valeur est exprimée en pixels.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| borderWidth | number | Valeur entière (pixels). Valeur minimale = 0 |
Objets pris en charge
Button ("custom" style) (with "custom" Border Line Style) - Check Box ("custom style") - Radio Button ("custom" style)
Rayon d'arrondi
Historique
| Release | Modifications |
|---|---|
| 21 R5 | Prise en charge des boutons, boutons radio et cases à cocher personnalisés |
| 19 R7 | Prise en charge pour les zones de saisie et de texte |
Définit l'arrondi des coins (en pixels) de l'objet. Par défaut, la valeur du rayon est de 0 pixel. Vous pouvez modifier cette propriété pour dessiner des objets arrondis avec des formes personnalisées :
La valeur minimale est de 0. Dans ce cas, un rectangle d'objet standard non arrondi est dessiné. La valeur maximale dépend de la taille du rectangle (elle ne peut pas dépasser la moitié de la taille du côté le plus court du rectangle) et est calculée dynamiquement.
Dans les zones de texte et les zones de saisie :
- la propriété rayon d"arrondi n'est disponible qu'avec les styles de ligne de bordure "none", "solid" ou "dotted",
- l'arrondi du coin est dessiné à l'extérieur de la zone de l'objet (l'objet apparaît plus grand dans le formulaire mais sa largeur et sa hauteur ne sont pas étendues).
Dans les boutons personnalisés (avec un style de bordure "personnalisé"), les cases à cocher personnalisées et les boutons radio personnalisés, le rayon d'arrondi est tracé à l'intérieur de la zone de l'objet.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| borderRadius | integer | minimum : 0 |
Objets pris en charge
Button ("custom" style) (with "custom" Border Line Style) - Check Box ("custom" style) - Input - Rectangle - Text Area - Radio Button ("custom" style)
Commandes
OBJECT GET CORNER RADIUS - OBJECT SET CORNER RADIUS
Type de pointillé
Décrit le type de ligne en pointillé comme une séquence de points noirs et blancs.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| strokeDashArray | tableau numérique ou texte | Ex : Ex : "6 1" ou [6,1] pour une séquence de 6 points noirs et 1 point blanc |
Objets pris en charge
Masquer lignes vides finales
Contrôle l'affichage des lignes vides supplémentaires ajoutées au bas d'un objet list box. Par défaut, 4D ajoute ces lignes supplémentaires pour remplir la zone vide :
Vous pouvez supprimer ces lignes vides en sélectionnant cette option. Le bas de l'objet list box est alors laissé vide :
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| hideExtraBlankRows | boolean | true, false |
Objets pris en charge
Commandes
LISTBOX Get property - LISTBOX SET PROPERTY
Couleur du trait
Désigne la couleur des lignes de l'objet. La couleur peut être spécifiée par :
- un nom de couleur - comme "red"
- une valeur HEX - comme "# ff0000"
- une valeur RVB - comme "rgb (255,0,0)"
Vous pouvez également définir cette propriété à l'aide de la commande OBJECT SET RGB COLORS.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| stroke | string | une valeur css; "transparent"; "automatic" |
This property is also available for objects with text properties, in which case it designates both the Font color and the object's lines, except if you used the Border color property.
Objets pris en charge
Commandes
OBJECT GET RGB COLORS - OBJECT SET RGB COLORS
Epaisseur du trait
Désigne l'épaisseur d'une ligne.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| strokeWidth | number | 0 pour la plus petite largeur dans un formulaire imprimé, ou toute valeur d'entier < 20 |
Objets pris en charge
Tableau couleurs de fond
List box de type tableau
Le nom d'un tableau pour appliquer une couleur d'arrière-plan personnalisée à chaque ligne ou colonne de la list box.
Le nom d'un tableau Entier long doit être saisi. Chaque élément de ce tableau correspond à une ligne de la zone de list box (si elle est appliquée à la liste box) ou à une cellule de la colonne (si elle est appliquée à une colonne), le tableau doit donc avoir la même taille que le tableau associé à la colonne. Vous pouvez utiliser les constantes décrites dans la commande OBJECT SET RGB COLORS. Si vous souhaitez que la cellule hérite de la couleur d'arrière-plan définie au niveau supérieur, passez la valeur -255 à l'élément de tableau correspondant.
Par exemple, considérons une list box où les lignes ont une couleur alternée gris/gris clair, définie dans les propriétés de la list box. Un tableau de couleurs d'arrière-plan a également été défini pour la list box afin de changer en orange clair la couleur des lignes où au moins une valeur est négative :
<>_BgndColors{$i}:=0x00FFD0B0 // orange
<>_BgndColors{$i}:=-255 // default value

Vous souhaitez ensuite colorer les cellules avec des valeurs négatives en orange foncé. Vous souhaitez ensuite colorer les cellules avec des valeurs négatives en orange foncé. Les valeurs de ces tableaux ont la priorité sur celles définies dans les propriétés de list box ainsi que sur celles du tableau de couleurs d'arrière-plan général :
<>_BgndColorsCol_3{2}:=0x00FF8000 // dark orange
<>_BgndColorsCol_2{5}:=0x00FF8000
<>_BgndColorsCol_1{9}:=0x00FF8000
<>_BgndColorsCol_1{16}:=0x00FF8000

Vous pouvez obtenir le même résultat en utilisant les commandes LISTBOX SET ROW FONT STYLE et LISTBOX SET ROW COLOR. Elles ont l'avantage de vous permettre d'éviter d'avoir à prédéfinir des tableaux de style/couleur pour les colonnes : ils sont créés dynamiquement par les commandes.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| rowFillSource | string | Nom d'un tableau entier long. |
Objets pris en charge
List Box - Colonne de List Box
Commandes
LISTBOX Get array - LISTBOX GET ARRAYS
Transparent
Définit l'arrière-plan de la list box sur "Transparent". Lorsqu'elle est définie, toute autre couleur d'arrière-plan ou couleur d'arrière-plan définie pour la colonne est ignorée.
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| fill | text | "transparent" |
Objets pris en charge
Commandes
OBJECT GET RGB COLORS - OBJECT SET RGB COLORS