Aller au contenu principal
Version: 20 R5

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

List Box Header


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
LeftLe texte est placé à gauche de l’icône. Le contenu du bouton est aligné à droite.
TopLe texte est placé au-dessus de l’icône. Le contenu du bouton est centré.
RightLe texte est placé à droite de l’icône. Le contenu du bouton est aligné à gauche.
BottomLe texte est placé en-dessous de l’icône. Le contenu du bouton est centré.
CenteredLe 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é :

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

Refer to the On Alternative Click event description for more information on the handling of events in this case.

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. The display of the pop-up menu and its values must be handled entirely by the developer, more particularly using form events and the Dynamic pop up menu and Pop up menu commands.

Grammaire JSON

NomType de donnéesValeurs possibles
popupPlacementstring
  • "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