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
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.
The picture can contain from 2 to 6 states.
- 2 states: false, true
- 3 states: false, true, rollover,
- 4 states: false, true, rollover, disabled,
- 5 states (check box and radio button only): false, true, false rollover, true rollover, disabled
- 6 states (check box and radio button only): false, true, false rollover, true rollover, false disabled, true disable.
- "false" means button not clicked/not selected or check box unchecked (variable value=0)
- "true" means button clicked/selected or check box checked (variable value=1)
Chaque état est représenté par une image différente. Dans l'image source, les états doivent être empilés verticalement :
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| iconFrames | number | Number of states in the icon picture. 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
Image hugs title
This property allows you to define whether the title and the picture of the button should be visually adjoined or separated, according to the Title/Picture position and Horizontal Alignment properties.
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).
By default, when a button contains a title and a picture, the elements are joined. The following graphic shows the effect of the imageHugsTitle property (true when property is enabled) with different button alignments:
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| imageHugsTitle | boolean | true (default), false |
Objets pris en charge
Button (all styles except Help) - Check Box (all styles except Regular, Flat, Disclosure and Collapse/Expand) - Radio Button (all styles except Regular, Flat, Disclosure and Collapse/Expand).
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é :
- Lorsque le pop up menu est séparé, un clic sur la partie gauche du bouton exécute directement l’action courante du bouton ; cette action peut être modifiée via le pop up menu accessible dans la partie droite du bouton.
- Lorsque le pop up menu est lié, un simple clic sur le bouton ne déclenche aucune autre action que l’affichage du pop up menu. Seule la sélection de l’action dans le pop up menu provoque son déclenchement.
Reportez-vous à la description de l'événement On Alternative Click pour plus d'informations sur la gestion des événements dans ce cas.
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 menu contextuel et de ses valeurs doit être entièrement géré par le développeur, plus particulièrement à l'aide des événements formulaire et des commandes Dynamic pop up menu et Pop up menu .
Grammaire JSON
| Nom | Type de données | Valeurs possibles |
|---|---|---|
| popupPlacement | string |
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