ListItem によって実装されるリストメンバには、リストセパレーターとその他の選択不可能なアイテムが含まれます。

ListItem オブジェクトには、次のようなリスト アイテムの状態に関する情報が含まれます。

• アイテムの値
• アイテムが選択されているかどうか
• アイテムが無効になっているかどうか
• コントロール内のアイテムの数値インデックス

ListItem はコントロールなしで存在したり、別のコントロールへの移動が可能ですが、本来 1 つのコントロールに対して直接的または間接的に作成されます。

コントロール内の ListItem はそのインデックス番号で識別できます。ListItem のインデックスを使用して、ListItem.selected? プロパティまたは enabled? プロパティを設定できます。下記の例を参照してください。無効の ListItem は選択できません。

ListItem は Graphic なので、サイズや色などのグラフィック オプションを変更できますが、ListItem の親を再設定したり、コントロールから削除することは推奨されていません。このようにすると、コントロールは正常に機能しなくなります。

既知のサブクラス：

• ListValueItem
• ListSeparator

{let list:ListBox =
    {ListBox
        "Red Pine", "White Pine", "Spruce", "Hemlock", "Balsam Fir"
    }
}
{set list[2].enabled? = false}
{value list}

ListItem とそのサブクラス ListValueItem は、コントロールのビジュアル レンダリングの高度な制御を要求するアプレットでサブクラス化されるために用意されています。たとえば、選択されたアイテムまたは無効のアイテムの外観を変更する場合を想定します。これを実行するには、サブクラスを作成して selected? セッターと enabled? オプション ハンドラをオーバーライドします。