コントロールのベースライン位置です。リスト内にアイテムがある場合、このベースライン位置は、アイテムレンダラーのベースライン位置に基づいて計算されます。ベースライン位置は、コンポーネントのテキストの 1 行目の y 座標です。

データプロバイダ内のアイテムをユーザーが編集できるかどうかを示すフラグです。true の場合、コントロール内のアイテムが編集可能です。ユーザーは、アイテムレンダラーをクリックすることでエディタを開くことができます。

デフォルト値false.

編集中のデータプロバイダアイテムに対応するアイテムレンダラーの列と行のインデックスです (存在する場合)。

このオブジェクトには、アイテムの 0 から始まる列とアイテムインデックスを示す columnIndex と rowIndex の 2 つのフィールドがあります。List コントロールでは、次のように、columnIndex プロパティは常に 0 です。 {columnIndex:0, rowIndex:3}.

このプロパティを設定すると、アイテムが表示されるまでスクロールし、itemEditBegin イベントを送出して、指定されたアイテムでアイテムエディタが開きます。

このプロパティはデータバインディングのソースとして使用できます。

編集中のアイテムが位置する DataGrid コントロール内のアイテムレンダラーへの参照です。

itemEditBegin イベントと itemEditEnd イベントのイベントリスナー内から、editedItemRenderer.data プロパティを使用して編集されているアイテムの現在値にアクセスできます。

リストアイテムの新しいデータを格納するアイテムエディタのプロパティの名前です。たとえば、デフォルトの itemEditor は TextInput であるため、editorDataField プロパティのデフォルト値は "text" となり、TextInput コントロールの text プロパティが指定されます。

アイテムレンダラーのサイズに対するアイテムエディタの高さです (ピクセル単位)。このプロパティを使うと、エディタをアイテムレンダラーと数ピクセル分オーバーラップさせて、エディタの周囲の境界線を補正することができます。

エディタの表示中にこれらの値を変更しても、それらの変更は現在のエディタに反映されませんが、次のアイテムレンダラーでエディタが開かれたときに反映されます。

デフォルト値0.

アイテムエディタで Enter キーを使用するかどうかを示すフラグです。このプロパティを true に設定すると、アイテムエディタで Enter キーを使用できます。この場合、List は Enter キーを検索せず、その操作に反応してエディタを移動します。

エディタの表示中にこの値を変更しても、それらの変更は現在のエディタに反映されませんが、次のアイテムレンダラーでエディタが開かれたときに反映されます。

デフォルト値false.

アイテムレンダラーのサイズに対するアイテムエディタの幅です (ピクセル単位)。このプロパティを使うと、エディタをアイテムレンダラーと数ピクセル分オーバーラップさせて、エディタの周囲の境界線を補正することができます。

エディタの表示中にこれらの値を変更しても、それらの変更は現在のエディタに反映されませんが、次のアイテムレンダラーでエディタが開かれたときに反映されます。

デフォルト値0.

アイテムの左上隅の位置に対するアイテムエディタの左上隅の x 軸上の位置です (ピクセル単位)。このプロパティを使うと、エディタをアイテムレンダラーと数ピクセル分オーバーラップさせて、エディタの周囲の境界線を補正することができます。

エディタの表示中にこれらの値を変更しても、それらの変更は現在のエディタに反映されませんが、次のアイテムレンダラーでエディタが開かれたときに反映されます。

デフォルト値0.

アイテムの左上隅の位置に対するアイテムエディタの左上隅の y 軸上の位置です (ピクセル単位)。このプロパティを使うと、エディタをアイテムレンダラーと数ピクセル分オーバーラップさせて、エディタの周囲の境界線を補正することができます。

エディタの表示中にこれらの値を変更しても、それらの変更は現在のエディタに反映されませんが、次のアイテムレンダラーでエディタが開かれたときに反映されます。

デフォルト値0.

IME (入力メソッドエディタ) のモードを指定します。IME を使用することによって、ユーザーは中国語、日本語、および韓国語のテキストを入力できます。Flex では、コントロールにフォーカスが置かれたときに、IME を指定されたモードに設定し、コントロールからフォーカスが離れたときに、元のモードに戻します。

flash.system.IMEConversionMode クラスで、このプロパティの有効な値の定数を定義します。IME をまったく指定しない場合は、null を指定します。

デフォルト値null.

関連項目

editable プロパティが true に設定されている場合にコントロールに使用するアイテムエディタのクラスファクトリです。

デフォルト値new ClassFactory(mx.controls.TextInput).

現在アクティブなアイテムエディタのインスタンスへの参照です (存在する場合)。

アイテムの編集中にアイテムエディタのインスタンスと新しいアイテム値にアクセスするには、itemEditorInstance プロパティを使用します。itemEditorInstance プロパティは、itemEditBegin イベントのイベントリスナーの実行後に初めて有効になります。したがって通常は、itemEditEnd イベントのイベントリスナー内から itemEditorInstance プロパティにアクセスするのみです。

itemEditor プロパティは、アイテムエディタのクラス (つまり、アイテムエディタインスタンスのデータ型) を定義します。

MXML でこのプロパティを設定することはありません。

アイテムレンダラーがアイテムエディタであるかどうかを指定します。このプロパティが true の場合、itemEditor プロパティの設定は無視されます。

デフォルト値false.

コンストラクタ。

itemEditor プロパティで指定されたエディタを使用して editedItemPosition のアイテムレンダラーに対応するアイテムエディタを作成します。

このメソッドは、エディタインスタンスを itemEditorInstance プロパティとして設定します。

itemEditBegin イベントに対するイベントリスナー内からのみ、このメソッドを呼び出すことができます。これ以外の時点でエディタを作成するには、itemEditBegin イベントを生成するように editedItemPosition プロパティを設定します。

アイテムに対して現在開かれているアイテムエディタを閉じます。通常、このメソッドは、preventDefault() メソッドを呼び出してデフォルトイベントリスナーの実行を防止した後に、itemEditEnd イベントのイベントリスナー内からのみ呼び出されます。

位置と高さの指定に従って行の背景を描画します。このメソッドは、入力された Sprite オブジェクトの子として Shape オブジェクトを作成し、適切な色で塗り潰します。このメソッドでは、backgroundAlpha スタイルプロパティの設定に基づいて、背景色の透明度を決定します。

データプロバイダ内のアイテムの編集を停止します。ユーザーがアイテムの編集を終了したとき、コントロールでこのメソッドが呼び出されます。itemEditEnd イベントを送出して、編集したデータを itemEditorInstance からデータプロバイダにコピーし、itemEditorInstance を非表示にするプロセスを開始します。

関連項目

候補の位置に候補の寸法でアイテムエディタインスタンスを配置します。Tree コントロールではこのメソッドをオーバーライドし、位置を調整してレンダラーのインデントを補正します。

新しい ListData インスタンスを作成し、入力されたデータプロバイダアイテムに基づいてフィールドに値を格納します。Tree コントロールではこのメソッドをオーバーライドし、Tree 関連のフィールドを追加します。

editedItemPosition プロパティが設定され、アイテムが編集可能になったときに送出されます。

ListEvent.ITEM_EDIT_BEGIN 定数は itemEditBegin イベントのイベントオブジェクトの type プロパティ値を定義し、アイテムが編集可能であることを示します。

このイベントのデフォルトリスナーは、次のアクションを実行します。

• createItemEditor() メソッドの呼び出しを通じてアイテムエディタオブジェクトを作成します。
• data プロパティをアイテムからエディタにコピーします。デフォルトでは、アイテムエディタオブジェクトは、TextInput コントロールのインスタンスです。リストコントロールの itemEditor プロパティを使用して、独自のアイテムエディタクラスを指定します。
• リストコントロールの itemEditorInstance プロパティを設定して、アイテムエディタインスタンスを参照するようにします。

このイベントのイベントリスナーを記述して、アイテムエディタに渡されるデータを変更できます。たとえば、データ、データのフォーマット、またはアイテムエディタで使用するその他の情報を変更できます。

イベントリスナーを作成して、アイテムの編集に使用するアイテムエディタを指定することもできます。たとえば、2 つの異なるアイテムエディタがあるとします。イベントリスナー内で編集するデータまたは他の情報を調べ、以下の手順に従って適切なアイテムエディタを開くことができます。

1. preventDefault() を呼び出すと、Flex が createItemEditor() メソッドがデフォルトイベントリスナーの一部として呼び出されるのを阻止できます。
2. 適切なエディタに itemEditor プロパティを設定します。
3. createItemEditor() メソッドを呼び出します。

イベントオブジェクトの各プロパティには次の値が設定されます。

ユーザーが、アイテム上、リストのタブ上、またはリスト内でマウスボタンを離したとき、またはその他の方法でアイテムを編集しようと試みたときに送出されます。

ListEvent.ITEM_EDIT_BEGINNING 定数は itemEditBeginning イベントの ListEvent オブジェクトの type プロパティ値を定義し、ユーザーがアイテム上でマウスボタンを離すなどの操作によってアイテムを編集できる状態にあることを示します。

このイベントのデフォルトリスナーによって、List.editedItemPosition プロパティがフォーカスを持つアイテムに設定されて、アイテムの編集セッションが開始されます。

通常では、このイベントに対する独自のイベントリスナーを記述して、特定のアイテムを編集できないようにします。このイベントの独自のイベントリスナー内から preventDefault() メソッドを呼び出すことによって、デフォルトリスナーの実行が阻止されます。

イベントオブジェクトの各プロパティには次の値が設定されます。

何らかの理由でアイテム編集セッションが終了するときに送出されます。

ListEvent.ITEM_EDIT_END 定数により、編集セッションが終了することを示す itemEditEnd イベントの ListEvent オブジェクトの type プロパティ値が定義されます。

List コンポーネントには、このイベントのデフォルトハンドラがあり、アイテムエディタから List コントロールのデータプロバイダにデータをコピーします。デフォルトのイベントリスナーは、次のアクションを実行します。

• List コントロールの editorDataField プロパティを使用して、新しいデータを収めたアイテムエディタのプロパティを判別し、その新しいデータでデータプロバイダアイテムを更新します。デフォルトのアイテムエディタは TextInput コントロールであるため、editorDataField プロパティのデフォルト値は "text" であり、TextInput の text プロパティに新しいアイテムデータが含まれることを指定します。
• destroyItemEditor() メソッドを呼び出してアイテムエディタを閉じます。

通常では、このイベントのイベントリスナーを記述して、次のアクションを実行します。

• イベントリスナーで、エディタから List コンポーネントに返されたデータを変更できます。たとえば、List コントロールにデータを返す前に、データを再フォーマットできます。デフォルトでは、アイテムエディタは単一の値のみ返すことができます。複数の値を返す場合は、itemEditEnd イベントのイベントリスナーを記述する必要があります。
• イベントリスナーで、アイテムエディタに入力されたデータを確認できます。データが正しくない場合は、preventDefault() メソッドを呼び出して、新しいデータが List コントロールに渡されないようにし、エディタが閉じるのを阻止できます。

イベントオブジェクトの各プロパティには次の値が設定されます。

アイテムレンダラーがフォーカスを得たときに送出されます。ユーザーが List コントロールのアイテムをクリックするか、キーボードを使用してアイテムに移動した場合に発生する可能性があります。リストアイテムが編集可能な場合にのみ送出されます。

ListEvent.ITEM_FOCUS_IN 定数は itemFocusIn イベントの ListEvent オブジェクトの type プロパティ値を定義し、アイテムがフォーカスを受け取ったことを示します。

イベントオブジェクトの各プロパティには次の値が設定されます。

アイテムレンダラーがフォーカスを失ったときに送出されます。ユーザーが List コントロール内またはリストの外部にある別のアイテムをクリックするか、キーボードを使用して List コントロールの内部または外部にある別のアイテムに移動した場合に発生する可能性があります。リストアイテムが編集可能な場合にのみ送出されます。

ListEvent.ITEM_FOCUS_OUT 定数は itemFocusOut イベントの ListEvent オブジェクトの type プロパティ値を定義し、アイテムがフォーカスを失ったことを示します。

イベントオブジェクトの各プロパティには次の値が設定されます。