Aller au contenu principal
Version: 19

Texte et Image

Chemin d'accès arrière-plan

Définit le chemin d'accès de l'image qui sera dessinée en arrière-plan de l'objet. Si l'objet utilise une icône avec différents états, l'image de fond prendra automatiquement en charge le même nombre d'états.

Le chemin d'accès à saisir est identique à celui de la propriété Chemin d'accès pour les images statiques.

Grammaire JSON

NomType de donnéesValeurs possibles
customBackgroundPicturestringChemin relatif en syntaxe POSIX. Doit être utilisé avec l'option "Personnalisé" de la propriété "Style".

Objets pris en charge

Bouton personnalisé - Case à cocher personnalisée - Bouton radio personnalisé


Styles de bouton

Aspect général du bouton. Le style du bouton joue également un rôle dans la disponibilité de certaines options.

Grammaire JSON

NomType de donnéesValeurs possibles
styletext"regular", "flat", "toolbar", "bevel", "roundedBevel", "gradientBevel", "texturedBevel", "office", "help", "circular", "disclosure", "roundedDisclosure", "custom"

Objets pris en charge

Bouton - Bouton radio - Case à cocher - Bouton radio


Marge horizontale

Cette propriété permet de définir la taille (en pixels) des marges horizontales du bouton. Cette marge délimite la zone que l'icône et le titre du bouton ne doivent pas dépasser.

Ce paramètre est utile, par exemple, lorsque l'image de fond contient des bordures :

Avec / SansExemple
Sans marge
Avec marge 13 pixels

Cette propriété fonctionne avec la propriété Marge verticale.

Grammaire JSON

NomType de donnéesValeurs possibles
customBorderXnumberA utiliser avec le style "personnalisé". Minimum: 0

Objets pris en charge

Bouton personnalisé - Case à cocher personnalisée - Bouton radio personnalisé


Emplacement de l'icône

Désigne l'emplacement d'une icône par rapport à l'objet formulaire.

Grammaire JSON

NomType de donnéesValeurs possibles
iconPlacementstring"aucun", "gauche", "droite"

Objets pris en charge

Entête de List Box


Décalage icône

Définit une valeur de décalage personnalisée en pixels, qui sera utilisée lorsque le bouton est cliqué

Le titre du bouton sera décalé vers la droite et vers le bas pour le nombre de pixels saisis. Cela permet d'appliquer un effet 3D personnalisé lorsque le bouton est cliqué.

Grammaire JSON

NomType de donnéesValeurs possibles
customOffsetnumberminimum : 0

Objets pris en charge

Bouton personnalisé - Case à cocher personnalisée - Bouton radio personnalisé


Nombre d'états

This property sets the exact number of states present in the picture used as the icon for a button with icon, a check box or a custom radio button. En général, une icône de bouton comprend quatre états : actif, cliqué, survolé et inactif.

Chaque état est représenté par une image différente. Dans l'image source, les états doivent être empilés verticalement :

Les états suivants sont représentés :

  1. bouton non cliqué / case non cochée (valeur de la variable = 0)
  2. bouton cliqué / case cochée (valeur de la variable = 1)
  3. survolé
  4. disabled

Grammaire JSON

NomType de donnéesValeurs possibles
iconFramesnumberminimum: 1

Objets pris en charge

Bouton (tous les styles saufAide) - Case à cocher - Bouton radio


Chemin d'accès de l'image

Définit le chemin d'accès de l'image qui sera utilisée comme icône de l'objet.

Le chemin d'accès à saisir est identique à celui de la propriété Chemin d'accès pour les images statiques.

Lorsqu'elle est utilisée comme icône pour les objets actifs, l'image doit être conçue pour prendre en charge un nombre d'états variable.

Grammaire JSON

NomType de donnéesValeurs possibles
icônepictureChemin relatif ou filesystem en syntaxe POSIX.

Objets pris en charge

Bouton (tous les styles saufAide) - Case à cocher - En-tête List boxBouton radio


Position Titre/Image

Cette propriété permet de modifier l’emplacement relatif du titre par rapport à l’icône associée. Cette propriété n’a pas d’effet lorsque le bouton contient uniquement un titre (pas d’image associée) ou une image (pas de titre). Par défaut, lorsqu’un bouton 3D contient un titre et une image, le texte est placé en-dessous de l’image.

Voici le résultat des différentes options de cette propriété :

OptionDescriptionExemple
GaucheLe texte est placé à gauche de l’icône. Le contenu du bouton est aligné à droite.
HautLe texte est placé au-dessus de l’icône. Le contenu du bouton est centré.
DroiteLe texte est placé à droite de l’icône. Le contenu du bouton est aligné à gauche.
BasLe texte est placé en-dessous de l’icône. Le contenu du bouton est centré.
CentreLe texte de l’icône est centré verticalement et horizontalement dans le bouton. Ce paramétrage convient par exemple pour du texte inclus dans une icône.

Grammaire JSON

NomType de donnéesValeurs possibles
textPlacementstring"left", "top", "right", "bottom", "center"

Objets pris en charge

Bouton (tous les styles saufAide) - Case à cocher - Bouton radio


Marge verticale

Cette propriété permet de définir la taille (en pixels) des marges verticales du bouton. Cette marge délimite la zone que l'icône et le titre du bouton ne doivent pas dépasser.

Ce paramètre est utile, par exemple, lorsque l'image de fond contient des bordures.

Cette propriété fonctionne avec la propriété Marge horizontale.

Grammaire JSON

NomType de donnéesValeurs possibles
customBorderYnumberA utiliser avec le style "personnalisé". Minimum: 0

Objets pris en charge

Bouton personnalisé - Case à cocher personnalisée - Bouton radio personnalisé


Avec pop-up menu

Cette propriété permet d’afficher un symbole en forme de triangle indiquant qu’un pop up menu lui est associé :

L’apparence et l’emplacement de ce symbole dépend du style de bouton et de la plate-forme courante.

Séparé et Lié

Pour associer un symbole de pop up menu à un bouton, vous disposez de deux options d’affichage :

LiéSéparé

La disponibilité effective d’un mode “Séparé” dépend du style de bouton et de la plate-forme.

Chaque option précise la relation entre le bouton et le pop up menu associé :

  • When the pop-up menu is **separated**, clicking on the left part of the button directly executes the current action of the button; this action can be modified using the pop-up menu accessible in the right part of the button.
  • When the pop-up menu is **linked**, a simple click on the button only displays the pop-up menu. Seule la sélection de l’action dans le pop up menu provoque son déclenchement.
  • Gestion du pop up menu

    Il est important de noter que la propriété “Avec pop up menu” gère uniquement l’aspect graphique du bouton. L’affichage du pop up menu et de ses valeurs doivent être entièrement gérés par le développeur, notamment à l’aide des événements formulaire et des commandes Pop up menu dynamique et Pop up menu.

    Grammaire JSON

    NomType de donnéesValeurs possibles
    popupPlacementstring
  • "none"
  • "linked"
  • "separated"
  • Objets pris en charge

    Bouton barre outils - Bouton Bevel - Bouton bevel circulaire - Bouton OS X Gradient - Bouton OS X Textured - Bouton Office XP - Bouton cercle - Personnalisé