XUL:prefwindow

Un article de MDC.

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

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

[modifier] 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>

[modifier] Attributs

Hérités de XUL element align, allowevents, allownegativeassertions, class, coalesceduplicatearcs, collapsed, container, containment, context, contextmenu, datasources, dir, empty, equalsize, flags, flex, height, hidden, id, insertafter, insertbefore, left, maxheight, maxwidth, menu, minheight, minwidth, mousethrough, observes, ordinal, orient, pack, persist, popup, position, preference-editable, querytype, ref, removeelement, sortDirection, sortResource, sortResource2, statustext, style, template, tooltip, tooltiptext, top, uri, wait-cursor, width

XUL:Attributs:buttonalign XUL:Attributs:buttondir XUL:Attributs:buttonorient XUL:Attributs:buttonpack XUL:Attributs:buttons XUL:Attributs:defaultButton XUL:Attributs:lastSelected XUL:Attributs:onbeforeaccept XUL:Attributs:ondialogaccept XUL:Attributs:ondialogcancel XUL:Attributs:ondialogdisclosure XUL:Attributs:ondialoghelp XUL:Attributs:onpanelload

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.

[modifier] Propriétés

Héritées de XUL element align, allowEvents, boxObject, builder, className, collapsed, contextMenu, controllers, currentItem, database, datasources, dir, flex, height, hidden, id, left, listBoxObject, maxHeight, maxWidth, menu, minHeight, minWidth, observes, ordinal, orient, pack, persist, ref, resource, statusText, style, tooltip, tooltipText, top, value, width Héritées de DOM element attributes, childNodes, cloneNode, firstChild, lastChild, localName, namespaceURI, nextSibling, nodeName, nodeType, nodeValue, ownerDocument, parentNode, prefix, previousSibling, tagName

XUL:Propriétés:buttons XUL:Propriétés:currentPane XUL:Propriétés:defaultButton XUL:Propriétés:lastSelected XUL:Propriétés:preferencePanes

type

Type : chaîne de caractères

Obtient et définit la valeur de l'attribut type.

[modifier] Méthodes

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

XUL:Méthodes:acceptDialog XUL:Méthodes:addPane XUL:Méthodes:cancelDialog XUL:Méthodes:centerWindowOnScreen XUL:Méthodes:getButton XUL:Méthodes:openSubDialog XUL:Méthodes:openWindow

showPane( prefpane )

Type retourné : aucune valeur retournée

Bascule vers un panneau en particulier.

[modifier] Sujets liés

À faire