Allgemeine Eigenschaften
Alle Komponenten können die folgenden allgemeinen Eigenschaften verwenden, etwa zum Hinzufügen eines Titels oder Symbols und zum Festlegen des Speicherorts der Konfiguration. Je nach Komponente können diese Eigenschaften unterschiedliche Wirkungen haben.
| Schlüssel | Typ | Beschreibung | Bedingung |
|---|---|---|---|
| cell | Zeichenfolge | Komponententyp | - |
| label | Zeichenfolge | Anzeigebezeichnung | Optional, lokalisierbar |
| defaults | Zeichenfolge | Kennung des Konfigurationsbereichs, also der Speichername der Komponentenkonfiguration | - |
| key | Zeichenfolge | Konfigurationsschlüssel | defaults != nil |
| default | Zeichenfolge | Standardwert der Konfiguration | - |
| value | Basistyp | Konfigurationswert | Optional |
| icon | Zeichenfolge | Dateiname des Symbols | Optional |
| readonly | Boolescher Wert | Ob die Komponente schreibgeschützt ist | Optional |
| height | Zahlenwert | Höhe der Komponente | Optional |
cell bezeichnet den Komponententyp; jeder Typ steht für eine andere XUI-Komponente, etwa Button, Switch oder Link.
label ist der Komponententitel und wird normalerweise links neben der Komponente angezeigt.
default ist der Standardwert der Komponente. Wenn value nil ist, wird value mit dem Wert von default gefüllt.
icon ist das Symbol und wird links von label angezeigt. Wenn res/16.png festgelegt ist, sollten auch res/[email protected] und res/[email protected] bereitgestellt werden; ihre tatsächlichen Abmessungen müssen jeweils dem Zwei- bzw. Dreifachen entsprechen.
Wenn readonly true ist, ist der Wert der Komponente schreibgeschützt und kann weder geändert noch geleert werden. Außerdem kann die Komponente nicht mit einer Unteroberfläche verknüpft werden.