Aller au contenu principal
Version: v20

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.

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.
note
  • "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

NomType de donnéesValeurs possibles
iconFramesnumberNumber 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

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


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

NomType de donnéesValeurs possibles
imageHugsTitlebooleantrue (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).


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

  • 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.
info

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

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é