mozilla

Compare Revisions

Preference XUL Attributes

Change Revisions

Revision 295882:

Revision 295882 by Wladimir_Palant on

Revision 544863:

Revision 544863 by Manishearth on

Title:
Preference XUL Attributes
Preference XUL Attributes
Slug:
Mozilla/Preferences/Preferences_system/New_attributes
Mozilla/Preferences/Preferences_system/New_attributes
Tags:
"XUL", "Preferences system"
"XUL", "Preferences system"
Content:

Revision 295882
Revision 544863
t48      <code>onsyncfrompreference</code> is called when an elementt48      <code>onsyncfrompreference</code> is called when an element
> is initialized from preferences. If you supply an implementation> is initialized from preferences. Specifically, when the value of
> of this event, your implementation will be invoked during initia> a preference element is loaded, all the elements using that pref
>lization and you can return the value with which to initialize th>erence will have their&nbsp;<span style="font-family: 'Courier Ne
>e UI element with, or <code>undefined</code> to tell the preferen>w', 'Andale Mono', monospace; line-height: normal;">onsyncfrompre
>ces system to initialize the UI element with the default value (i>ference&nbsp;</span><span style="line-height: 1.5;">handler calle
>.e. to attempt to initialize with the preference value). In the a>d.</span>
>bove example, you might write the checkbox like this: 
49    </p>
50    <div class="warning">
51      Be careful when writing&nbsp;<span style="font-family: 'Cou
 >rier New', 'Andale Mono', monospace; line-height: normal;">onsync
 >frompreference&nbsp;</span><span style="line-height: 1.5;">handle
 >rs. &nbsp;</span><span style="font-family: 'Courier New', 'Andale
 > Mono', monospace; line-height: normal;">&lt;preference&gt;&nbsp;
 ></span><span style="line-height: 1.5;">elements defined after the
 > preference <em><strong>element</strong></em> &nbsp;being dealt w
 >ith will not yet have their&nbsp;</span><span style="font-family:
 > 'Courier New', 'Andale Mono', monospace; line-height: normal;">v
 >alue</span><span style="line-height: 1.5;">&nbsp;set, so referrin
 >g to them from the handler will lead to a null result. Reorder th
 >e&nbsp;</span><span style="font-family: 'Courier New', 'Andale Mo
 >no', monospace; line-height: normal;">&lt;preference&gt;&nbsp;</s
 >pan><span style="line-height: 1.5;">elements or directly fetch th
 >e preference value via&nbsp;</span><span style="font-family: 'Cou
 >rier New', 'Andale Mono', monospace; line-height: normal;">Servic
 >es.prefs</span>
52    </div>
53    <p>
54      <span style="line-height: 1.5;">If you supply an implementa
 >tion of this event, your implementation will be invoked during in
 >itialization and you can return the value with which to initializ
 >e the UI element with, or</span> <code style="font-size: 14px;">u
 >ndefined</code> <span style="line-height: 1.5;">to tell the prefe
 >rences system to initialize the UI element with the default value
 > (i.e. to attempt to initialize with the preference value). In th
 >e above example, you might write the checkbox like this:</span>

Back to History