XUL:preference
出典: MDC
« XUL リファレンス HOME [ 例 | 属性 | プロパティ | メソッド | 関連項目 ]
prefpane で調整される設定を宣言します。この要素は preferences 要素内に置かれなければなりません。各 preference 要素はユーザの設定ファイルに格納された設定に相当します。checkbox などのユーザインタフェース要素を preference 要素につなぐには、その要素の preference 属性を使用してください。
詳しい情報が設定システムの記事にあります。
- 属性
- disabled, instantApply, inverted, name, onchange, readonly, tabindex, type
- プロパティ
- disabled, inverted, locked, name, preferences, readonly, tabIndex, type, value
- メソッド
- hasUserValue, reset
(例が必要)
[編集] 属性
|
XUL 要素からの継承
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
|
- disabled
- 型: 真偽値
- 要素が無効化されているかどうかを示します。ある要素が
true に設定されていたら、その要素は無効化されています。無効化された要素は通常グレイ表示のテキストで描画されます。要素が無効化されていると、ユーザのアクションには応答せず、フォーカスもあてられず、command イベントも発生しません。
- instantApply
- 型: boolean
-
true の場合、ユーザインタフェースが変更されるとすぐに設定が反映されます。
- inverted
- 型: boolean
- 真偽値の preference について、この属性が
true に設定されると、preference の値がこの要素に関連付けられたユーザインタフェース要素の値と逆の値を示します。つまり、checkbox にチェックを入れると、preference が有効になる代わりに無効になります。
- name
- 型: string
- 変更する preference の名前。例えば、browser のホームページは
browser.startup.homepage で設定されます。
- onchange
- 型: script code
-
onchange 属性内のコードは、要素の値が変更された時、呼び出されます。
- readonly
- 型: boolean
-
true に設定した場合、ユーザは要素の値を変更できません。しかし、スクリプトからは依然として値を変更できます。
- tabindex
- 型: 整数
- 要素のタブの順番。タブの順番は tab キーが押下されたときにフォーカスが移動する順番です。より大きな
tabindex の値をもつ要素は、タブの遷移が後になります。
- type
- 型: 以下の値のいずれか一つ
- preference の形式。次の値のうちの一つになります。
-
bool: true または false どちらかに設定される真偽値。普通は checkbox がこれらの設定につなげられます。
-
int: 整数値。
-
string: 文字列。
-
unichar: Unicode 文字列。
-
wstring: ローカライズされた文字列。この場合、preference は、preference の実際の値を含むプロパティファイルへのパスを保存します。
-
file: ファイル。設定内にファイルへのパスが格納されます。
[編集] プロパティ
|
XUL 要素からの継承
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
DOM 要素からの継承
attributes,
childNodes,
cloneNode,
firstChild,
lastChild,
localName,
namespaceURI,
nextSibling,
nodeName,
nodeType,
nodeValue,
ownerDocument,
parentNode,
prefix,
previousSibling,
tagName
|
- disabled
- 型: 真偽値
- disabled 属性の値の取得と設定。
- inverted
- 型: boolean
- inverted 属性の値の取得と設定。
- locked
- 型: boolean
-
true の場合、システム設定内で preference をロックして無効化し、値が変更されるのを防ぎます。このプロパティは読み取り専用です。
- name
- 型: string
- 変更する preference の名前。例えば、browser のホームページは
browser.startup.homepage で設定されます。
- preferences
- 型: element
- preferences を含む要素への参照。
- readonly
- 型: boolean
-
true に設定すると、ユーザは要素の値を変更できなくなります。
-
このすべて小文字のプロパティは
preference 要素でのみ使用され、後のバージョンで名前が
readOnly に変更されます。他の要素は
readOnly プロパティを使用します。これに対応する属性名はすべて小文字の
readonly です。
- tabIndex
- 型: 整数
- tabindex 属性の値の取得と設定。
- type
- 型: string
- type 属性の値の取得と設定。
- value
- 型: 文字列
- value 属性の値の取得と設定。
[編集] メソッド
- hasUserValue()
- 戻り値の型: boolean
- preference がそのデフォルト値から変更されたとき、
true を返します。
- reset()
- 戻り値の型: 戻り値なし
- preference の値をデフォルトにリセットします。
- textbox については、アンドゥ処理リストを消去します (Gecko 1.9)。
|
XUL 要素からの継承
blur,
click,
doCommand,
focus,
getElementsByAttribute
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
|
[編集] 関連項目
TBD