共通プロパティ

各コンポーネントでは、タイトルやアイコンの追加、設定の保存先の指定などに、次の共通プロパティを使用できます。これらの共通プロパティの役割は、コンポーネントによって異なる場合があります。

キー	型	説明	条件
cell	文字列	コンポーネントの種類	-
label	文字列	表示ラベル	任意、ローカライズ可能
defaults	文字列	設定領域の識別子（このコンポーネントの設定を保存する名前）	-
key	文字列	設定のキー名	defaults != nil
default	文字列	設定のデフォルト値	-
value	基本型	設定値	任意
icon	文字列	アイコンのファイル名	任意
readonly	ブール値	コンポーネントを読み取り専用にするかどうか	任意
height	数値	コンポーネントの高さ	任意

cell はコンポーネントの種類です。種類ごとに、Button、Switch、Link などの異なる XUI コンポーネントを表します。

label はコンポーネントのタイトルで、通常はコンポーネントの左側に表示されます。

default はコンポーネントのデフォルト値です。value が nil の場合、default の値が value に設定されます。

icon は、label の左側に表示されるアイコンです。res/16.png を指定する場合は、res/[email protected] と res/[email protected] も用意することを推奨します。実際のサイズは、それぞれ元の 2 倍と 3 倍にする必要があります。

readonly が true の場合、コンポーネントの値は読み取り専用となり、変更も空値への設定もできません。また、サブ画面へリンクすることもできません。