path: root/files/ja/archive/mozilla/xul/prefwindow/index.html

---
title: prefwindow
slug: Archive/Mozilla/XUL/prefwindow
tags:
  - XUL Elements
  - XUL Reference
translation_of: Archive/Mozilla/XUL/prefwindow
---
<div class="noinclude"><span class="breadcrumbs XULRef_breadcrumbs">
 « <a href="/ja/docs/XUL/XUL_Reference">XUL リファレンス HOME</a>    [
 <a href="#Examples">例</a> |
 <a href="#Attributes">属性</a> |
 <a href="#Properties">プロパティ</a> |
 <a href="#Methods">メソッド</a> |
 <a href="#Related">関連項目</a> ]
</span></div>
<p>設定ダイアログに使用される特別なウィンドウ。この要素は <code><a href="/ja/docs/Mozilla/Tech/XUL/window" title="window">window</a></code> タグの中に置いて使用し、一つ以上の <code><a href="/ja/docs/Mozilla/Tech/XUL/prefpane" title="prefpane">prefpane</a></code> 要素を含めなければなりません。ボタンの行が preference ダイアログの各 prefpane すべてに現れます。通常、各ペインは関連する設定が一つのグループにまとめられます。一つの <code><a href="/ja/docs/Mozilla/Tech/XUL/prefpane" title="prefpane">prefpane</a></code> しかないときは、ナビゲーション領域が隠されます。</p>
<p>変更がすぐに適用される慣習のあるプラットフォーム上では、ユーザインタフェース要素が変更されるとすぐに設定が調整されます。他のプラットフォーム上では、ダイアログが閉じられるまで設定が適用されません。</p>
<p>設定ウィンドウをは、他のダイアログと同じように、window の <code>openDialog</code> メソッドを使用して開くことができます。デフォルトで指定のペインを開くには、<code>openDialog</code> の四番目の引数に特定のペインの <code id="a-id"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/id">id</a></code> を渡します。また、<code>prefwindow</code> タグ上の <code id="a-lastSelected"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/lastSelected">lastSelected</a></code> 属性に開始するペインの <code id="a-id"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/id">id</a></code> を設定して指定することもできます。通常は、この属性を設定しなくても、設定ダイアログを最後に閉じた時に表示していたものが自動的にデフォルトのペインとして設定されます。</p>
<p>詳しい情報が<a href="/ja/Preferences_System" title="ja/Preferences_System">設定システム</a>の記事にあります。</p>
<p><strong>XULrunner ベースのアプリケーションに対しての重要な注意事項</strong>: 設定システム (toolkit の一部分) は、依然、二つの browser.* 設定に頼っています。一つ目は真偽値を設定する browser.preferences.instantApply です。preference ウィンドウは、あなたのアプリケーションのデフォルト値にこれが設定されていないと正しく動作しません (詳しくは <a class="link-https" href="https://bugzilla.mozilla.org/show_bug.cgi?id=485150" title="https://bugzilla.mozilla.org/show_bug.cgi?id=485150">bug 485150</a> を参照)。この設定値が true の場合、設定ウィンドウでユーザが設定を選択すると、OK ボタンを押してダイアログを閉じなくても設定がすぐに適用されます。二つ目は同じく真偽値を設定する browser.preferences.animateFadeIn です。これは XULrunner ベースのアプリケーションで省略できますが、デフォルトの動作設定 (Mac OS X では true、その他のプラットフォームでは false) を上書きできます。</p>
<dl> <dt>属性</dt> <dd><a href="#a-buttonalign">buttonalign</a>, <a href="#a-buttondir">buttondir</a>, <a href="#a-buttonorient">buttonorient</a>, <a href="#a-buttonpack">buttonpack</a>, <a href="#a-buttons">buttons</a>, <a href="#a-defaultButton">defaultButton</a>, <a href="#a-lastSelected">lastSelected</a>, <a href="#a-onbeforeaccept">onbeforeaccept</a>, <a href="#a-ondialogaccept">ondialogaccept</a>, <a href="#a-ondialogcancel">ondialogcancel</a>, <a href="#a-ondialogdisclosure">ondialogdisclosure</a>, <a href="#a-ondialoghelp">ondialoghelp</a>, <a href="#a-onpaneload">onpaneload</a>, <a href="#a-title">title</a>, <a href="#a-prefwindow.type">type</a></dd>
</dl>
<dl> <dt>プロパティ</dt> <dd><a href="#p-buttons">buttons</a>, <a href="#p-currentPane">currentPane</a>, <a href="#p-defaultButton">defaultButton</a>, <a href="#p-lastSelected">lastSelected</a>, <a href="#p-preferencePanes">preferencePanes</a>, <a href="#p-type">type</a></dd>
</dl>
<dl> <dt>メソッド</dt> <dd><a href="#m-acceptDialog">acceptDialog</a>, <a href="#m-addPane">addPane</a>, <a href="#m-cancelDialog">cancelDialog</a>, <a href="#m-centerWindowOnScreen">centerWindowOnScreen</a>, <a href="#m-getButton">getButton</a>, <a href="#m-openSubDialog">openSubDialog</a>, <a href="#m-openWindow">openWindow</a>, <a href="#m-showPane">showPane</a></dd>
</dl>
<h3 id="Examples" name="Examples">例</h3>
<pre class="eval">   &lt;?xml version="1.0"?&gt;
   &lt;?xml-stylesheet href="<a class=" external" rel="freelink">chrome://global/skin/</a>" type="text/css"?&gt;
   &lt;prefwindow xmlns="<span class="nowiki">http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</span>"&gt;
     &lt;prefpane id="saveoptions" label="Backups"&gt;
       &lt;preferences&gt;
         &lt;preference id="pref-backup" name="myapp.mybackups" type="bool"/&gt;
         &lt;preference id="pref-backupduration" name="myapp.mybackups.duration" type="int"/&gt;
       &lt;/preferences&gt;
       &lt;checkbox label="Automatically Save Backups" preference="pref-backup"/&gt;
       &lt;textbox label="Duration:" preference="pref-backupduration"/&gt;
     &lt;/prefpane&gt;
   &lt;/prefwindow&gt;
</pre>
<h3 id="Attributes" name="Attributes">属性</h3>
<p> </p><div id="a-activetitlebarcolor">

<dl><dt> <code id="a-activetitlebarcolor"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/activetitlebarcolor">activetitlebarcolor</a></code>  </dt><dd> 型: <em>color 文字列</em> </dd><dd> ウィンドウがアクティブな時のタイトルバーについて、背景色を指定された色にし、ウィンドウ内容との間の境界線を非表示にします。<em>この属性は Mac OS X でのみ有効です。</em> </dd></dl>

</div> <div id="a-buttonalign">

<dl><dt> <code id="a-buttonalign"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/buttonalign">buttonalign</a></code> </dt><dd> 型: <em>文字列型</em> </dd><dd> box が含むボタンのための <code id="a-align"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/align">align</a></code> 属性の値。 </dd></dl>

</div> <div id="a-buttondir">

<dl><dt> <code id="a-buttondir"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/buttondir">buttondir</a></code> </dt><dd> 型: <em>文字列型</em> </dd><dd> box が含むボタンのための <code id="a-dir"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/dir">dir</a></code> 属性の値。 </dd></dl>

</div> <div id="a-buttonorient">

<dl><dt> <code id="a-buttonorient"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/buttonorient">buttonorient</a></code> </dt><dd> 型: <em>文字列型</em> </dd><dd> box が含むボタンのための <code id="a-orient"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/orient">orient</a></code> 属性の値。 </dd></dl>

</div> <div id="a-buttonpack">

<dl><dt> <code id="a-buttonpack"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/buttonpack">buttonpack</a></code> </dt><dd> 型: <em>文字列型</em> </dd><dd> box が含むボタンのための <code id="a-pack"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/pack">pack</a></code> 属性の値。 </dd></dl>

</div> <div id="a-buttons">

<dl><dt> <code id="a-buttons"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/buttons">buttons</a></code> </dt><dd> 型: <em>カンマで区切られた下記の値のリスト</em> </dd><dd> ダイアログボックス中に現れるボタンをカンマで区切ったリスト。ボタンはユーザのプラットフォームに適した位置に置かれ、基本的なイベントハンドリングが自動で行われます。次の値をリストで使用することができます。 </dd></dl>
<ul> <li><code>accept</code>: 押下すると変更を許諾する OKボタンです。このボタンがデフォルトになります。</li> <li><code>cancel</code>: 操作を中止するキャンセルボタンです。</li> <li><code>help</code>: ダイアログについてのヘルプを表示するヘルプボタンです。</li> <li><code>disclosure</code>: 追加の情報を表示するボタンです。これはボタンになるか、情報を表示する三角形になります。</li> <li><code>extra1</code>:任意で追加されるボタンです。<code><code id="a-buttonlabelextra1"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/buttonlabelextra1">buttonlabelextra1</a></code></code> 属性でこのボタンのラベルを設定することができます。</li> <li><code>extra2</code>: 任意で追加されるもう一つのボタンです。<code><code id="a-buttonlabelextra2"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/buttonlabelextra2">buttonlabelextra2</a></code></code> 属性でこのボタンのラベルを設定することができます。</li>
</ul>
<div class="note"><strong>註:</strong> ダイアログボックス内にボタンを表示したくないときは、属性の値に "," (カンマ 1 つ) を設定してください。</div>

</div> <div id="a-defaultButton">

<dl><dt> <code id="a-defaultButton"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/defaultButton">defaultButton</a></code> </dt><dd> 型: <em>文字列型</em> </dd><dd> 通常、この属性を設定すべきではありません。設定すると、ダイアログ内のデフォルトボタンを指定します。一般的に、これは Enter キーが押された時にボタンが有効化されることを意味します。この属性には <code id="a-buttons"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/buttons">buttons</a></code> 属性で設定できる値と同じものを設定します。 </dd></dl>

</div> <div id="a-inactivetitlebarcolor">

<dl><dt> <code id="a-inactivetitlebarcolor"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/inactivetitlebarcolor">inactivetitlebarcolor</a></code>  </dt><dd> 型: <em>color 文字列</em> </dd><dd> ウィンドウが非アクティブな時のタイトルバーについて、背景色を指定された色にし、ウィンドウ内容との間の境界線を非表示にします。<em>この属性は Mac OS X でのみ有効です。</em> </dd></dl>

</div> <div id="a-lastSelected">

<dl><dt> <code id="a-lastSelected"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/lastSelected">lastSelected</a></code> </dt><dd> 型: <em>文字列型</em> </dd><dd> 最後に選択されたペインの <code id="a-id"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/id">id</a></code> を設定します。次に設定ダイアログを開いたとき、このペインがデフォルトで開かれます。 </dd></dl>

</div> <div id="a-onbeforeaccept">

<dl><dt> <code id="a-onbeforeaccept"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/onbeforeaccept">onbeforeaccept</a></code> </dt><dd> 型: <em>スクリプトコード</em> </dd><dd> この属性内のコードは、OK ボタンが押された時、または <span id="m-acceptDialog"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/acceptDialog">acceptDialog</a></code></span> メソッドが呼ばれた時に呼び出されます。 </dd></dl>

</div> <div id="a-ondialogaccept">
<p> </p>

<dl><dt> <code id="a-ondialogaccept"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/ondialogaccept">ondialogaccept</a></code> </dt><dd> 型: <em>スクリプトコード</em> </dd><dd> この属性内のコードは、accept ボタンが押された時、もしくは <span id="m-acceptDialog"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/acceptDialog">acceptDialog</a></code></span> メソッドが呼ばれた時に呼ばれます。ハンドラが <code>true</code> を返す場合、ダイアログは閉じますが、<code>false</code> を返す場合、閉じることはありません。 </dd></dl>

</div> <div id="a-ondialogcancel">

<dl><dt> <code id="a-ondialogcancel"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/ondialogcancel">ondialogcancel</a></code> </dt><dd> 型: <em>スクリプトコード</em> </dd><dd> この属性内のコードは、"cancel" ボタンが押されたとき、または <span id="m-cancelDialog"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/cancelDialog">cancelDialog</a></code></span> メソッドが呼ばれたときに呼び出されます。このルーチンが true を返す場合、そのままダイアログが閉じられます。false を返す場合は閉じられません。 </dd></dl>

</div> <div id="a-ondialogdisclosure">

<dl><dt> <code id="a-ondialogdisclosure"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/ondialogdisclosure">ondialogdisclosure</a></code> </dt><dd> 型: <em>スクリプトコード</em> </dd><dd> この属性内のコードは、"disclosure" ボタンが押された時、呼び出されます。 </dd></dl>

</div> <div id="a-ondialoghelp">

<dl><dt> <code id="a-ondialoghelp"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/ondialoghelp">ondialoghelp</a></code> </dt><dd> 型: <em>スクリプトコード</em> </dd><dd> この属性内のコードは、"help" ボタンが押されたとき呼び出されます。 </dd></dl>

</div> <div id="a-onpaneload">

<dl>
  <dt>
    <code id="a-onpaneload"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/onpaneload">onpaneload</a></code></dt>
  <dd>
    型: <em>スクリプトコード</em></dd>
  <dd>
    ここで定義されたコードは、window の <code>load</code> イベントのように、ペインが読み込まれた時、呼び出されます。</dd>
</dl>
</div> <div id="a-title">

<dl><dt> <code id="a-title"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/title">title</a></code> </dt><dd> 型: <em>文字列型</em> </dd><dd> window のタイトルバーに表示するためのテキスト。 </dd></dl>

</div> <div id="a-prefwindow.type">

<dl><dt> <code id="a-prefwindow.type"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/prefwindow.type">type</a></code> </dt><dd> 型: <em>文字列型</em> </dd><dd> メイン設定ウィンドウの子ダイアログには、この属性を <code>child</code> に設定してください。プラットフォームにとって適切な動作であれば、設定はメインダイアログが閉じられた時のみ保存されます。 </dd></dl>

</div>
<h3 id="Properties" name="Properties">プロパティ</h3>
<p> </p><div id="p-buttons">

<dl>
 <dt><code><span><a href="https://developer.mozilla.org/ja/docs/XUL/Property/buttons">buttons</a></span></code></dt>
 <dd>型: <em>下記の値をカンマで区切ったリスト</em></dd>
 <dd>ダイアログボックス中に現れるボタンをカンマで区切ったリスト。ボタンはユーザのプラットフォームに適した位置に置かれ、基本的なイベントハンドリングが自動で行われます。次の値をリストで使用することができます:
<ul>
 <li><code>accept</code>: 押下すると変更を許諾する OKボタンです。このボタンがデフォルトになります。</li>
 <li><code>cancel</code>: 操作を中止するキャンセルボタンです。</li>
 <li><code>help</code>: ダイアログについてのヘルプを表示するヘルプボタンです。</li>
 <li><code>disclosure</code>: 追加の情報を表示するボタンです。これはボタンになるか、情報を表示する三角形になります。</li>
 <li><code>extra1</code>: 任意で追加されるボタンです。<code><code id="a-buttonlabelextra1"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/buttonlabelextra1">buttonlabelextra1</a></code></code> 属性でこのボタンのラベルを設定することができます。</li>
 <li><code>extra2</code>: 任意で追加されるもう一つのボタンです。<code><code id="a-buttonlabelextra2"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/buttonlabelextra2">buttonlabelextra2</a></code></code> 属性でこのボタンのラベルを設定することができます。</li>
</ul>
</dd>
</dl></div> <div id="p-currentPane">
<dl><dt> <code><span><a href="https://developer.mozilla.org/ja/docs/XUL/Property/currentPane">currentPane</a></span></code> </dt><dd> 型: <em><code><a href="/ja/docs/Mozilla/Tech/XUL/prefpane" title="prefpane">prefpane</a></code> 要素</em> </dd><dd> 現在表示されているペインへの参照。現在のペインを変更するには <span id="m-showPane"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/showPane">showPane</a></code></span> メソッドを使用してください。 </dd></dl>
</div> <div id="p-defaultButton">
<dl><dt> <code><span><a href="http://api/ja/docs/XUL/Property/defaultButton">defaultButton</a></span></code> </dt><dd> 型: <em>文字列型</em> </dd><dd> 通常、この属性を設定すべきではありません。設定すると、ダイアログ内のデフォルトボタンを指定します。一般的に、これは Enter キーが押下された時にボタンが有効化されることを意味します。この属性には <code id="a-buttons"><a href="http://api/ja/docs/Mozilla/Tech/XUL/Attribute/buttons">buttons</a></code> 属性で設定できる値と同じものを設定します。 </dd></dl>
</div>
<dl> <dt><code>instantApply</code> （読み取り専用）</dt> <dd>ウィンドウが "instant apply" モード（設定の変更が即座に適用されるモード）かどうかを示します。値は真偽値のユーザ設定 <code>browser.preferences.instantApply</code> から読み込まれます。（?? それは <code>&lt;field&gt;</code> として宣言されているため、あなたは値を書き換える事が<em>できます</em>が、私はそれが正しい事とは思えません。）</dd>
</dl>
<div id="p-lastSelected">
<dl><dt> <code><span><a href="https://developer.mozilla.org/ja/docs/XUL/Property/lastSelected">lastSelected</a></span></code> </dt><dd> 型: <em>文字列型</em> </dd><dd> 最後に選択されたペインの id を設定します。次に設定ダイアログを開いたとき、このペインがデフォルトで開かれます。 </dd></dl>
</div> <div id="p-preferencePanes">
<dl><dt> <code><span><a href="https://developer.mozilla.org/ja/docs/XUL/Property/preferencePanes">preferencePanes</a></span></code> </dt><dd> 型: <em>DOM NodeList</em> </dd><dd> window 内のすべての <code><a href="/ja/docs/Mozilla/Tech/XUL/prefpane" title="prefpane">prefpane</a></code> 要素のリストを保持します。 </dd></dl>
</div> <div id="p-type">

<dl>
  <dt>
    <code><span><a href="https://developer.mozilla.org/ja/docs/XUL/Property/type">type</a></span></code></dt>
  <dd>
    型: <em>文字列型</em></dd>
  <dd>
    <code id="a-type"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/type">type</a></code> 属性の値の取得と設定。</dd>
</dl>

</div>
<h3 id="Methods" name="Methods">メソッド</h3>
<table style="border: 1px solid rgb(204, 204, 204); margin: 0 0 10px 10px; padding: 0 10px; background: rgb(238, 238, 238); float: right; width: 250px;">
<tbody>
<tr>
<td>
<p><strong>XUL 要素からの継承</strong><br>
<small> <span id="m-blur"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/blur">blur</a></code></span>, <span id="m-click"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/click">click</a></code></span>, <span id="m-doCommand"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/doCommand">doCommand</a></code></span>, <span id="m-focus"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/focus">focus</a></code></span>, <span id="m-getElementsByAttribute"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/getElementsByAttribute">getElementsByAttribute</a></code></span> <span id="m-getElementsByAttributeNS"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/getElementsByAttributeNS">getElementsByAttributeNS</a></code></span></small></p> <p><strong>DOM 要素からの継承</strong><br>
<small> <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.addEventListener">addEventListener()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.appendChild">appendChild()</a></code>, <a href="/ja/DOM/Node.compareDocumentPosition" title="ja/DOM/Node.compareDocumentPosition">compareDocumentPosition</a>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.dispatchEvent">dispatchEvent()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.getAttribute">getAttribute()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.getAttributeNode">getAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.getAttributeNodeNS">getAttributeNodeNS()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.getAttributeNS">getAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.getElementsByTagName">getElementsByTagName()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.getElementsByTagNameNS">getElementsByTagNameNS()</a></code>, <a href="/ja/DOM/Node.getFeature" title="ja/DOM/Node.getFeature">getFeature</a>, <a href="/ja/DOM/Node.getUserData" title="ja/DOM/Node.getUserData">getUserData</a>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.hasAttribute">hasAttribute()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.hasAttributeNS">hasAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.hasAttributes">hasAttributes()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.hasChildNodes">hasChildNodes()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.insertBefore">insertBefore()</a></code>, <a href="/ja/DOM/Node.isEqualNode" title="ja/DOM/Node.isEqualNode">isEqualNode</a>, <a href="/ja/DOM/Node.isSameNode" title="ja/DOM/Node.isSameNode">isSameNode</a>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.isSupported">isSupported()</a></code>, <a href="/ja/DOM/Node.lookupNamespaceURI" title="ja/DOM/Node.lookupNamespaceURI">lookupNamespaceURI</a>, <a href="/ja/DOM/Node.lookupPrefix" title="ja/DOM/Node.lookupPrefix">lookupPrefix</a>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.normalize">normalize()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.removeAttribute">removeAttribute()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.removeAttributeNode">removeAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.removeAttributeNS">removeAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.removeChild">removeChild()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.removeEventListener">removeEventListener()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.replaceChild">replaceChild()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.setAttribute">setAttribute()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.setAttributeNode">setAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.setAttributeNodeNS">setAttributeNodeNS()</a></code>, <code><a href="https://developer.mozilla.org/ja/docs/DOM/element.setAttributeNS">setAttributeNS()</a></code>, <a href="/ja/DOM/Node.setUserData" title="ja/DOM/Node.setUserData">setUserData</a></small></p>

</td>
</tr>
</tbody>
</table> <dl>
  <dt>
    <span id="m-acceptDialog"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/acceptDialog">acceptDialog()</a></code></span></dt>
  <dd>
    戻り値の型: <em>戻り値なし</em></dd>
  <dd>
    dialog に同意して閉じます。OK ボタンの押下と似ています。</dd>
</dl> <dl>
  <dt>
    <span id="m-addPane"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/addPane">addPane( prefpane )</a></code></span></dt>
  <dd>
    戻り値の型: <em>戻り値なし</em></dd>
  <dd>
    ペインのリストに <code><a href="/ja/docs/Mozilla/Tech/XUL/prefpane" title="prefpane">prefpane</a></code> を追加します。</dd>
</dl> <dl>
  <dt><span id="m-cancelDialog"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/cancelDialog">cancelDialog()</a></code></span></dt>
  <dd>戻り値の型: <em>戻り値無し</em></dd>
  <dd>dialog をキャンセルして閉じます。Cancel ボタンの押下と似ています。</dd>
</dl>
<dl> <dt><code>animate(aOldPane, aNewPane)</code></dt> <dd>これはおそらく公開メソッドではありません（？）。</dd>
</dl>
<dl>
  <dt><span id="m-centerWindowOnScreen"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/centerWindowOnScreen">centerWindowOnScreen()</a></code></span></dt>
  <dd>戻り値の型: <em>戻り値無し</em></dd>
  <dd>dialog をスクリーンの中央に配置します。</dd>
</dl> <dl>
  <dt><span id="m-getButton"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/getButton">getButton( type )</a></code></span></dt>
  <dd>戻り値の型: <em>button 要素</em></dd>
  <dd>指定した <var>type</var> に一致する、 dialog 内の <code><a href="/ja/docs/Mozilla/Tech/XUL/button" title="button">button</a></code> 要素を返します。</dd>
</dl> <dl>
  <dt><span id="m-openSubDialog"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/openSubDialog">openSubDialog( url, features, params )</a></code></span></dt>
  <dd>戻り値の型: <em>window</em></dd>
  <dd>子ダイアログを開きます。通常、このメソッドはユーザに詳細オプションを設定させるために使用します。引数は window の <a href="/ja/docs/DOM/window.openDialog"><code>openDialog</code></a> に似ていますが、window 名を提供する必要はありません。<var>url</var> は XUL ファイルでなければなりません。子ダイアログも <code><a href="/ja/docs/Mozilla/Tech/XUL/prefwindow" title="prefwindow">prefwindow</a></code> である場合は、その <code id="a-type"><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Attribute/type">type</a></code> 属性を <code>child</code> に設定してください。メインダイアログが閉じられた時、その設定が保存されます。</dd>
</dl> <dl>
  <dt><span id="m-openWindow"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/openWindow">openWindow( windowtype, url, features, params )</a></code></span></dt>
  <dd>戻り値の型: <em>window</em></dd>
  <dd>子ウィンドウを開きます。<var>windowtype</var> は window 形式を指定する文字列です。指定した形式のウィンドウがすでに開かれている場合、このメソッドは、もう一つのウィンドウを開く代わりに、そのウィンドウにフォーカスを切り替えて最前面に表示します。指定した形式のウィンドウが開かれていない場合、与えられた <var>url</var> を表示する新しいウィンドウが開かれます。</dd>
</dl> <dl>
  <dt><span id="m-showPane"><code><a href="https://developer.mozilla.org/ja/docs/Mozilla/Tech/XUL/Method/showPane">showPane( prefpane )</a></code></span></dt>
  <dd>戻り値の型: <em>戻り値無し</em></dd>
  <dd>特定のペインに表示を切り替えます。</dd>
</dl>
<p>注意。あなたは、そのサブウィンドウが既に開かれている時に <code>openWindow()</code> を使って渡されたパラメータを受け取るために、<code>initWithParams()</code> という関数をサブウィンドウの中で定義する事ができます。例えば Firefox のパーミッションマネージャの UI は同じウィンドウを画像、ソフトウェアのインストール、ポップアップのブロックの3つのダイアログのために使っています。このウィンドウでは <code>initWithParams()</code> を、ウィンドウを開き直さずにダイアログの種類を変えるために使っています。</p>
<p>以下のような使い方がお薦めです：</p>
<pre>// subwindow.js
function onLoad(ev) {
  // 何らかの初期化処理

  initWithParams(window.arguments[0]); // 1つのパラメータだけがウィンドウに渡される事を期待しています。
}

function initWithParams(aParams) {
  // これは、ウィンドウが既に開かれていて openWindow() で再度フォーカスされる時に呼ばれるでしょう。
}</pre>
<h3 id="Notes" name="Notes">注意点</h3>
<h4 id="Opening_a_modal_sub_dialog" name="Opening_a_modal_sub_dialog">モーダルなサブダイアログを開く場合</h4>
<p>サブダイアログは <code>document.documentElement</code> を経由してのみ開く事ができ、<code>window</code> からは開けません。従って、<code>openSubDialog()</code> を呼び出す例は以下のようになります：</p>
<pre class="eval">document.documentElement.openSubDialog("<a class=" external" rel="freelink">chrome://myextension/content/options-sub.xul</a>", "", null)
</pre>
<h4 id="Issues_when_using_prefpanes_in_prefwindow" name="Issues_when_using_prefpanes_in_prefwindow">prefwindow で prefpane を使う時の問題</h4>
<p>-&lt;prefpane&gt; 以外の要素を prefwindow に置きたいと思った場合、それらはすべての &lt;prefpane&gt; よりも後に置くべきです。prefpane 以外の要素を最初の &lt;prefpane&gt; よりも前に置いた場合、ペインの切り替え時におかしな挙動を目にするかもしれません。これは <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=296418" title="can't put tags/elements before prefpane elements in prefwindow">バグ 296418</a> によるものです。</p>
<p>間違った例：</p>
<pre class="eval">&lt;prefwindow&gt;
  &lt;script src="config.js"/&gt;
  &lt;prefpane label="pane1" src="pane1.xul"/&gt;
  &lt;prefpane label="pane2" src="pane2.xul"/&gt;
&lt;/prefwindow&gt;
</pre>
<p>正しい例：</p>
<pre class="eval">&lt;prefwindow&gt;
  &lt;prefpane label="pane1" src="pane1.xul"/&gt;
  &lt;prefpane label="pane2" src="pane2.xul"/&gt;
  &lt;script src="config.js"/&gt;
&lt;/prefwindow&gt;
</pre>
<h3 id="Related" name="Related">関連項目</h3>
<p><code><a href="/ja/docs/Mozilla/Tech/XUL/prefpane" title="prefpane">prefpane</a></code></p>
<div class="moreinfo">  <p><strong><a href="/ja/docs/Preferences_System">設定システム</a>の資料:</strong></p>  <ul>    <li>簡単な紹介: <a href="/ja/docs/Preferences_System/Getting_Started">Getting Started</a> | <a href="/ja/docs/Preferences_System/Examples">サンプル</a> | <a href="/ja/docs/Preferences_System/Troubleshooting">トラブルシューティング</a></li>    <li>リファレンス: <code><a href="/ja/docs/Mozilla/Tech/XUL/prefwindow" title="prefwindow">prefwindow</a></code> | <code><a href="/ja/docs/Mozilla/Tech/XUL/prefpane" title="prefpane">prefpane</a></code> | <code><a href="/ja/docs/Mozilla/Tech/XUL/preferences" title="preferences">preferences</a></code> | <code><a href="/ja/docs/Mozilla/Tech/XUL/preference" title="preference">preference</a></code> | <a href="/ja/docs/Preferences_System/New_attributes">新しい属性</a></li>  </ul></div>