Une fenêtre spécialisée utilisée pour les dialogues de préférences. Cet élément devrait être utilisé à la place de la balise window
et contenir un ou plusieurs éléments prefpane
. Une rangée de boutons apparait dans tout le dialogue de préférences, un par prefpane
. Chaque panneau servira généralement à regrouper un ensemble de préférences liées. Si il n'y a qu'un prefpane
, la zone de navigation n'apparaitra pas.
Sur les plateformes où la convention est d'appliquer les changements immédiatement, les préférences sont ajustées dès que l'élément d'interface utilisateur a changé. Sur les autres plateformes, les préférences ne sont pas appliquées tant que le dialogue n'est pas fermé.
Il est possible d'ouvrir une fenêtre de préférences à l'aide de la méthode openDialog
d'une fenêtre comme pour d'autres dialogues. L'id
d'un panneau particulier peut être passé comme quatrième paramètre de openDialog
pour ouvrir un panneau particulier par défaut. Il est également possible de définir l'attribut lastSelected
sur la balise prefwindow
en lui donnant l'id
du panneau avec lequel démarrer. Cet attribut n'est normalement pas défini, comme il sera positionné automatiquement afin que le panneau par défaut soit le dernier que celui qui était affiché la dernière fois que le dialogue a été fermé.
Pour plus d'informations, consultez l'article Système de préférences.
- Attributs
- buttonalign, buttondir, buttonorient, buttonpack, buttons, defaultButton, lastSelected, onbeforeaccept, ondialogaccept, ondialogcancel, ondialogdisclosure, ondialoghelp, onpanelload, title, type
- Propriétés
- buttons, currentPane, defaultButton, lastSelected, preferencePanes, type
- Méthodes
- acceptDialog, addPane, cancelDialog, centerWindowOnScreen, getButton, openSubDialog, openWindow, showPane
Exemples
<prefwindow xmlns="https://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
<prefpane id="saveoptions" label="Backups">
<preferences>
<preference id="pref-backup" name="myapp.mybackups" type="bool"/>
<preference id="pref-backupduration" name="myapp.mybackups.duration" type="int"/>
</preferences>
<checkbox label="Automatically Save Backups" preference="pref-backup"/>
<textbox label="Duration:" preference="pref-backupduration"/>
</prefpane>
</prefwindow>
Attributs
-
title
- Type : chaîne de caractères
- Le texte qui doit apparaître dans la barre de titre de la fenêtre ou boîte de dialogue.
Propriétés
Méthodes
-
showPane( <i>prefpane</i> )
- Type retourné : aucune valeur retournée
- Bascule vers un panneau en particulier.
Sujets liés
À faire