prefwindow

par 3 contributeurs :

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="http://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

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

Méthodes

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

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()

showPane( <i>prefpane</i> )
Type retourné : aucune valeur retournée
Bascule vers un panneau en particulier.


Sujets liés

À faire

Étiquettes et contributeurs liés au document

Étiquettes : 
Contributeurs à cette page : lmorchard, Mgjbot, BenoitL
Dernière mise à jour par : lmorchard,