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

Nom	Type de données	Valeurs possibles
customBackgroundPicture	string	Chemin 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

Nom	Type de données	Valeurs possibles
style	text	"regular", "flat", "toolbar", "bevel", "roundedBevel", "gradientBevel", "texturedBevel", "office", "help", "circular", "disclosure", "roundedDisclosure", "custom"

Objets pris en charge

Bouton - Bouton radio - Case à cocher - Bouton radio

---

Horizontal Margin

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 / Sans	Exemple
Sans marge
Avec marge 13 pixels

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

Grammaire JSON

Nom	Type de données	Valeurs possibles
customBorderX	number	A 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

Nom	Type de données	Valeurs possibles
iconPlacement	string	"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

Nom	Type de données	Valeurs possibles
customOffset	number	minimum : 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

Nom	Type de données	Valeurs possibles
iconFrames	number	minimum: 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

Nom	Type de données	Valeurs possibles
icône	picture	Chemin relatif ou filesystem en syntaxe POSIX.

Objets pris en charge

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

---

Title/Picture Position

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é :

Option	Description	Exemple
Gauche	Le texte est placé à gauche de l’icône. Le contenu du bouton est aligné à droite.
Haut	Le texte est placé au-dessus de l’icône. Le contenu du bouton est centré.
Droite	Le texte est placé à droite de l’icône. Le contenu du bouton est aligné à gauche.
Bas	Le texte est placé en-dessous de l’icône. Le contenu du bouton est centré.
Centre	Le 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

Nom	Type de données	Valeurs possibles
textPlacement	string	"left", "top", "right", "bottom", "center"

Objets pris en charge

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

---

Vertical Margin

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

Nom	Type de données	Valeurs possibles
customBorderY	number	A 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

Nom	Type de données	Valeurs possibles
popupPlacement	string	"none" "linked" "separated"

Objets pris en charge

Toolbar Button - Bevel Button - Rounded Bevel Button - OS X Gradient Button - OS X Textured Button - Office XP Button - Circle Button - Custom