Vos résultats de recherche

preference

Dans cet article

« Accueil de la référence XUL [ Exemples | Attributs | Propriétés | Méthodes | Sujets liés ]

Déclare une préférence qui peut être ajustée dans un prefpane. Cet élément doit être placé à l'intérieur d'un élément preferences. Chaque élément preference correspond à une préférence qui est stockée dans le fichier de préférences de l'utilisateur. Il est possible de connecter un élément d'interface utilisateur comme une case à cocher à un élément de préférence à l'aide de l'attribut preference de l'élément d'interface utilisateur.

Pour plus d'informations, consultez l'article Système de préférences.

Attributs: disabled, instantApply, inverted, name, onchange, readonly, tabindex, type

Propriétés: disabled, inverted, locked, name, preferences, readonly, tabIndex, type, value

Méthodes: hasUserValue, reset

Exemples

(exemple nécessaire)

Attributs

disabled: Type : booléen; Indique si l'élément est ou non désactivé. Si cette valeur est définie à true, l'élément est désactivé. Les éléments désactivés sont habituellement affichés avec leur texte grisé. Si l'élément est désactivé, il ne répond pas aux actions de l'utilisateur, il ne peut pas recevoir le focus, et l'évènement command ne se déclenchera pas.

<!-- La case à cocher active/désactive le bouton -->
<checkbox label="Enable button" 
    onclick="document.getElementById('buttRemove').disabled = this.checked"/>
<button id="buttRemove" label="Remove All" disabled="true"/>

instantApply: Type : booléen; Si sa valeur est true, la préférence sera modifiée dès que l'élément d'interface utilisateur est modifié.

inverted: Type : booléen; Pour les préférences booléennes, l'indication de cet attribut à true indique que la valeur de la préférence est l'inverse de celle de l'élément d'interface utilisateur qui y est attaché. Par exemple, elle fait en sorte que cocher une case désactive la préférence associée au lieu de l'activer.

name: Type : chaîne de caractères; Le nom de la préférence à modifier. Par exemple, la page d'accueil du navigateur est définie par la préférence browser.startup.homepage.

onchange: Type : code de script; Le code figurant dans l'attribut onchange est appelé lorsque la valeur de l'élément est modifiée.

readonly: Type : booléen; Si défini à true, l'utilisateur ne peut pas modifier la valeur de l'élément. Cependant, celle-ci peut toujours être modifiée par un script.

tabindex: Type : entier; L'ordre de tabulation de l'élément. L'ordre de tabulation est l'ordre dans lequel le focus se déplace lorsque l'utilisateur appuie sur la touche « tab ». Les éléments dont le tabindex est plus haut se trouvent plus tard dans la séquence de tabulation.

type: Type : une des valeurs ci-dessous; Le type de préférence qui doit être une des valeurs suivantes.

bool : Un booléen défini à true ou false. Habituellement, on connectera un élément checkbox à ce type de préférence.
int : Un entier
string : Une chaîne de caractères
unichar : Une chaîne de caractères Unicode
wstring : Une chaîne localisée. Dans cette situation, la préférence enregistrera le chemin vers un fichier de propriétés contenant la valeur réelle de la préférence.
file : Un fichier. Le chemin vers le fichier sera stocké dans la préférence.

Propriétés

disabled: Type : booléen; Obtient et définit la valeur de l'attribut disabled.

inverted: Type : booléen; Obtient et définit la valeur de l'attribut inverted.

locked: Type : booléen; Si définie à true, la préférence a été verrouillée et désactivée dans la configuration système, ce qui empêche de changer sa valeur. Cette propriété est en lecture seule.

name: Type : chaîne de caractères; Le nom de la préférence (élément preference) à modifier. Par exemple, la page d'accueil du navigateur est définie par la préférence browser.startup.homepage.

preferences: Type : élément; Référence à l'élément preferences conteneur.

readonly: Type : booléen; Si définie à true, l'utilisateur ne peut pas modifier la valeur de l'élément.; Cette propriété toute en minuscules n'est utilisée qu'avec l'élément preference et sera peut-être renommée en readOnly dans des versions ultérieures. D'autres éléments utilisent la propriété readOnly. L'attribut correspondant est cependant readonly en minuscules.

tabIndex: Type : entier; Obtient et définit la valeur de l'attribut tabindex.

type: Type : chaîne de caractères; Obtient et définit la valeur de l'attribut type.

value: Type : chaîne; Obtient et définit la valeur de l'attribut value.

Méthodes

hasUserValue(): Type de retour : booléen; Renvoie true si la préférence a été modifiée par rapport à sa valeur par défaut.

reset(): Type de retour : aucune valeur renvoyée; Réinitialise la préférence à sa valeur par défaut.; Pour un élément textbox, la liste de transactions d'annulation est également vidée (Gecko 1.9).

Héritées de XUL element
blur, click, doCommand, focus, getElementsByAttribute

Héritées de DOM element
addEventListener(), appendChild(), dispatchEvent(), getAttribute(), getAttributeNode(), getAttributeNodeNS(), getAttributeNS(), getElementsByTagName(), getElementsByTagNameNS(), hasAttribute(), hasAttributeNS(), hasAttributes(), hasChildNodes(), insertBefore(), isSupported(), normalize(), removeAttribute(), removeAttributeNode(), removeAttributeNS(), removeChild(), removeEventListener(), replaceChild(), setAttribute(), setAttributeNode(), setAttributeNodeNS(), setAttributeNS()

Sujets liés

À faire

Étiquettes et contributeurs liés au document

Étiquettes :

Éléments_XUL

Contributeurs à cette page : lmorchard, BenoitL, Mgjbot

Dernière mise à jour par : lmorchard, 14 juin 2012 à 18:12:09