Propriétés communes

Tous les composants peuvent utiliser les propriétés communes suivantes pour ajouter un titre, une icône et indiquer l’emplacement d’enregistrement de la configuration. Leur rôle peut varier selon le composant.

Clé	Type	Description	Condition
cell	Chaîne	Type de composant	-
label	Chaîne	Étiquette affichée	Facultatif, localisable
defaults	Chaîne	Identifiant de section de configuration, c’est-à-dire le nom de stockage de la configuration du composant	-
key	Chaîne	Nom de la clé de configuration	defaults != nil
default	Chaîne	Valeur de configuration par défaut	-
value	Type de base	Valeur de configuration	Facultatif
icon	Chaîne	Nom du fichier d’icône	Facultatif
readonly	Booléen	Indique si le composant est en lecture seule	Facultatif
height	Nombre	Hauteur du composant	Facultatif

cell est le type de composant ; chaque type représente un composant XUI différent, comme Button, Switch ou Link.

label est le titre du composant, généralement affiché à gauche du composant.

default est la valeur par défaut du composant ; si value vaut nil, la valeur de default est utilisée pour remplir value.

icon est l’icône affichée à gauche de label. Si elle est définie sur res/16.png, il est recommandé de fournir également res/[email protected] et res/[email protected], dont les dimensions doivent être respectivement deux et trois fois supérieures.

Si readonly vaut true, la valeur du composant est en lecture seule, ne peut pas être modifiée ni vidée, et le composant ne peut pas être lié à une sous-interface.