Wyniki wyszukiwania

prefwindow

W tym artykule

« Dokumentacja XUL [ Przykłady | Atrybuty | Własności | Metody | Podobne ]

Okno wyspecjalizowane do okien preferencji. Ten element powinien być użyty zamiast znacznika window i powinien zawierać jeden lub więcej elementów prefpane. Rząd przycisków pojawia się w oknie preferencji, po jednym przycisku dla każdego elementu prefpane. Każdy panel zwykle zawiera w sobie grupę podobnych ustawień. Jeśli istnieje tylko jeden element prefpane, przestrzeń nawigacyjna nie zostanie wyświetlona.

W przypadku platform, w których ustawienia muszą zostać zastosowane natychmiastowo, są one zmieniane w momencie, kiedy element interfejsu jest zmieniony. Na innych platformach, ustawienia nie zostają zastosowane zanim okno jest zamknięte.

Możesz otworzyć okno preferencji używając metody openDialog okna, tak jak z innymi oknami dialogowymi. Możesz przekazać id odpowiedniego panelu jako czwarty argument openDialog, aby domyślnie otworzyć odpowiedni panel. Możesz również ustawić atrybut lastSelected znacznika prefwindow na id panela, od którego chcesz zacząć. Zwykle, nie będziesz ustawiać tego atrybutu, jako że zostanie on automatycznie ustawiony w taki sposób, że domyślnym panelem stanie się ten sam panel, który był wyświetlany, kiedy okno preferencji było ostatnio zamknięte.

Więcej informacji dostępne jest w artykule System preferencji.

Atrybuty: buttonalign, buttondir, buttonorient, buttonpack, buttons, defaultButton, lastSelected, onbeforeaccept, ondialogaccept, ondialogcancel, ondialogdisclosure, ondialoghelp, onpanelload, title, type

Własności: buttons, currentPane, defaultButton, lastSelected, preferencePanes, type

Metody: acceptDialog, addPane, cancelDialog, centerWindowOnScreen, getButton, openSubDialog, openWindow, showPane

Przykłady

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

Atrybuty

buttonalign: Typ: string; Wartość atrybutu align dla pudełka zawierającego przyciski.

buttondir: Typ: string; Wartość atrybutu dir dla pudełka zawierającego przyciski.

buttonorient: Typ: string; Wartość atrybutu orient dla pudełka zawierającego przyciski.

buttonpack: Typ: string; Wartość atrybutu pack dla pudełka zawierającego przyciski.

buttons: Typ: rozdzielona przecinkami lista poniższych wartości; Rozdzielona przecinkami lista przycisków do wyświetlenia w okienku dialogowym. Przyciski zostaną umieszczone w odpowiednim miejscu w zależności od platformy systemowej użytkownika, a podstawowa obsługa zdarzeń zostanie wykonana automatycznie. Następujące wartości mogą zostać użyte w tej liście:

accept: Przycisk OK, który będzie akceptował zmiany po naciśnięciu. Ten przycisk będzie także przyciskiem domyślnym.
cancel: Przycisk Anuluj, który będzie anulował operacje.
help: Przycisk Pomoc służący do wyświetlenia okienka pomocy.
disclosure: Przycisk pokazujący więcej informacji. Może być to przycisk lub trójkąt rozwijający.
extra1: Opcjonalny przycisk dodatkowy. Można ustawić jego etykietę za pomocą atrybutu buttonlabelextra1.
extra2: Drugi opcjonalny przycisk dodatkowy. Można ustawić jego etykietę za pomocą atrybutu buttonlabelextra2.

defaultButton: Typ: string; Zwykle nie powinno się ustawiać tego atrybutu. Określa on domyślny przycisk w oknie dialogowym. Zazwyczaj oznacza to, że przycisk zostanie aktywowany po naciśnięciu klawisza Enter. Atrybutowi temu powinna być przypisana jedna z wartości używanych przez atrybut buttons.

lastSelected: Typ: string; Ustaw to na id ostatniego zaznaczonego okna. Będzie otwierany domyślnie następnym razem, gdy okno preferencji jest otwarte.

onbeforeaccept: Typ: Kod skryptu; Kod w tym atrybucie jest wywołany kiedy przycisk OK zostaje naciśnięty lub kiedy wywołana zostaje metoda acceptDialog.

ondialogaccept: Typ: kod skryptu; Kod w tym atrybucie jest wywołany po naciśnięciu przycisku akceptacji lub po wywołaniu metody acceptDialog.

ondialogcancel: Typ: kod skryptu; Kod w tym atrybucie jest wywołany po naciśnięciu przycisku 'Anuluj' lub po wywołaniu metody cancelDialog.

ondialogdisclosure: Typ: Kod skryptu; Kod w tym atrybucie jest wywołany po naciśnięciu przycisku ujawniającego (ang. disclosure).

ondialoghelp: Typ: kod skryptu; Kod w tym atrybucie jest wywołany po naciśnięciu przycisku 'Pomoc'.

onpaneload: Typ: kod skryptu; Zdefiniowany tutaj kod jest wywołany kiedy okno będzie wczytane, bardzo podobnym zdarzeniem dla okna jest load.

title: Typ: string; Tekst wyświetlony na pasku tytułu w oknie dialogowym.

Zobacz

Własności

buttons: Typ: rozdzielona przecinkami lista poniższych wartości; Rozdzielona przecinkami lista przycisków do wyświetlenia w okienku dialogowym. Przyciski zostaną umieszczone w odpowiednim miejscu w zależności od platformy systemowej użytkownika, a podstawowa obsługa zdarzeń zostanie wykonana automatycznie. Następujące wartości mogą zostać użyte w tej liście:

accept: Przycisk OK, który będzie akceptował zmiany po naciśnięciu. Ten przycisk będzie także przyciskiem domyślnym.
cancel: Przycisk Anuluj, który będzie anulował operację.
help: Przycisk Pomoc służący do wyświetlenia okienka pomocy.
disclosure: Przycisk pokazujący więcej informacji. Może być to przycisk lub trójkąt rozwijający.
extra1: Opcjonalny przycisk dodatkowy. Można ustawić jego etykietę za pomocą atrybutu buttonlabelextra1.
extra2: Drugi opcjonalny przycisk dodatkowy. Można ustawić jego etykietę za pomocą atrybutu buttonlabelextra2.

currentPane: Typ: element prefpane; Odniesienie do aktualnie wyświetlanego okna. Aby zmienić bieżące okno zastosuj metodę showPane.

defaultButton: Typ: string; Zwykle nie powinno się ustawiać tej własności. Określa ona domyślny przycisk w oknie dialogowym. Zazwyczaj oznacza to, że przycisk zostanie aktywowany po naciśnięciu klawisza Enter. Własności tej powinna być przypisana jedna z wartości używanych przez atrybut buttons.

lastSelected: Typ: string; Ustawia to na id ostatniego zaznaczonego okna. Będzie otwarte domyślnie następnym razem, kiedy zostanie otwarte okno preferencji.

preferencePanes: Typ: DOM NodeList; Podtrzymuje listę wszystkich elementów prefpane w oknie.

type: Typ: string; Pobiera i ustawia wartość atrybutu type.

Metody

Dziedziczy z elementu XUL
blur, click, doCommand, focus, getElementsByAttribute getElementsByAttributeNS

Dziedziczy z elementu DOM
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()

acceptDialog(): Zwraca typ: nie zwraca wartości; Akceptuje okienko dialogowe i je zamyka, działa podobnie jak naciśnięcie przycisku OK.

addPane( prefpane ): Zwraca typ: nie zwraca wartości; Dołącza prefpane do listy okien.

cancelDialog(): Zwraca typ: nie zwraca wartości; Anuluje okienko dialogowe i je zamyka, działa podobnie jak naciśnięcie przycisku <tt>Anuluj</tt>.

centerWindowOnScreen(): Zwraca typ: nie zwraca wartości; Ustawia okienko dialogowe na środku ekranu.

getButton( typ ): Zwraca typ: element button; Zwraca element button o zadanym typie, znajdujący się w okienku dialogowym.

openSubDialog( url, features, params ): Return type: window; Opens a child modal dialog. Usually this method would be used to allow the user to configure advanced options. The arguments are similar to the window's openDialog method except that the window name does not need to be supplied. The url should be a XUL file. If the child dialog is also a prefwindow, set its type attribute to child so that preferences will be saved properly when the main dialog is closed.

openWindow( windowtype, url, features, params ): Zwraca typ: window; Otwiera potomne okno. <var>windowtype</var> jest łańcuchem znaków określającym typ okna. Jeśli okno jest z tym typem, które jest teraz otwarte, to metoda ta będzie przełączała to okno na wierzch i stanie się aktywne, zamiast otwarcia kolejnego okna. Jeśli typ okna nie jest otwarty, nowe jest otwierane wyświetlając dostarczony <var>url</var>.

showPane( prefpane ): Zwraca typ: nie zwraca wartości; Włącza specjalne okno.

Podobne

TBD

Autorzy i etykiety dokumentu

Etykiety:

Autorzy tej strony: teoli, lmorchard, Mgjbot, Ptak82, VooEak

Ostatnia aktualizacja: teoli, 29.05.2014, 05:52:55