パッケージ | mx.events |
クラス | public class DataGridEvent |
継承 | DataGridEvent Event Object |
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
関連する API エレメント
プロパティ | 定義元 | ||
---|---|---|---|
bubbles : Boolean [読み取り専用]
イベントがバブリングイベントかどうかを示します。 | Event | ||
cancelable : Boolean [読み取り専用]
イベントに関連付けられた動作を回避できるかどうかを示します。 | Event | ||
columnIndex : int
DataGrid オブジェクトの columns 配列の、イベントに関連付けられた列の 0 から始まるインデックスです。 | DataGridEvent | ||
constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | ||
currentTarget : Object [読み取り専用]
イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 | Event | ||
dataField : String
列に関連付けられているデータ内のフィールドまたはプロパティの名前です。 | DataGridEvent | ||
eventPhase : uint [読み取り専用]
イベントフローの現在の段階です。 | Event | ||
itemRenderer : IListItemRenderer
編集中のアイテムに対応するアイテムレンダラーか、クリックまたは展開されたヘッダーレンダラーです。 | DataGridEvent | ||
localX : Number
列の伸縮イベントを再生する場合の列の x 座標の位置です。 | DataGridEvent | ||
reason : String
itemEditEnd イベントが送出された理由です。 | DataGridEvent | ||
rowIndex : int
データプロバイダーのアイテムの 0 から始まるインデックスです。 | DataGridEvent | ||
target : Object [読み取り専用]
イベントターゲットです。 | Event | ||
type : String [読み取り専用]
イベントのタイプです。 | Event |
メソッド | 定義元 | ||
---|---|---|---|
DataGridEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, dataField:String = null, rowIndex:int = -1, reason:String = null, itemRenderer:IListItemRenderer = null, localX:Number = NaN)
コンストラクターです。 | DataGridEvent | ||
Event サブクラスのインスタンスを複製します。 | Event | ||
カスタム ActionScript 3.0 Event クラスに toString() メソッドを実装するためのユーティリティ関数です。 | Event | ||
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | ||
イベントで preventDefault() メソッドが呼び出されたかどうかを確認します。 | Event | ||
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | ||
イベントのデフォルト動作をキャンセルできる場合に、その動作をキャンセルします。 | Event | ||
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | ||
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | ||
イベントフローの現在のノードおよび後続するノードで、イベントリスナーが処理されないようにします。 | Event | ||
イベントフローの現在のノードに後続するノードで、イベントリスナーが処理されないようにします。 | Event | ||
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | ||
Event オブジェクトのすべてのプロパティを含むストリングを返します。 | Event | ||
指定されたオブジェクトのプリミティブな値を返します。 | Object |
定数 | 定義元 | ||
---|---|---|---|
COLUMN_STRETCH : String = "columnStretch" [静的]
DataGridEvent.COLUMN_STRETCH 定数は、columnStretch イベントのイベントオブジェクトの type プロパティ値を定義し、ユーザーが列を水平方向に展開したことを示します。 | DataGridEvent | ||
HEADER_RELEASE : String = "headerRelease" [静的]
DataGridEvent.HEADER_RELEASE 定数は、headerRelease イベントのイベントオブジェクトの type プロパティ値を定義し、ユーザーが列ヘッダーの上でマウスを押して離したことを示します。 | DataGridEvent | ||
ITEM_EDIT_BEGIN : String = "itemEditBegin" [静的]
DataGridEvent.ITEM_EDIT_BEGIN 定数は、itemEditBegin イベントのイベントオブジェクトの type プロパティ値を定義し、アイテムが編集可能であることを示します。 | DataGridEvent | ||
ITEM_EDIT_BEGINNING : String = "itemEditBeginning" [静的]
DataGridEvent.ITEM__EDIT_BEGINNING 定数は、itemEditBeginning イベントのイベントオブジェクトの type プロパティ値を定義し、ユーザーがアイテム上でマウスボタンを離すなどの操作によってアイテムを編集できる状態にあることを示します。 | DataGridEvent | ||
ITEM_EDIT_END : String = "itemEditEnd" [静的]
DataGridEvent.ITEM_EDIT_END 定数は、itemEditEnd イベントのイベントオブジェクトの type プロパティ値を定義し、編集セッションが終了することを示します。 | DataGridEvent | ||
ITEM_EDITOR_CREATE : String = "itemEditorCreate" [静的]
DataGridEvent.ITEM_EDITOR_CREATE 定数は、イベントオブジェクトの type プロパティ値を itemEditorCreate イベント用に定義し、データグリッドでアイテムエディターの作成が完了したことを示します。 | DataGridEvent | ||
ITEM_FOCUS_IN : String = "itemFocusIn" [静的]
DataGridEvent.ITEM_FOCUS_IN 定数は、itemFocusIn イベントのイベントオブジェクトの type プロパティ値を定義し、アイテムがフォーカスを受け取ったことを示します。 | DataGridEvent | ||
ITEM_FOCUS_OUT : String = "itemFocusOut" [静的]
DataGridEvent.ITEM_FOCUS_OUT 定数は、itemFocusOut イベントのイベントオブジェクトの type プロパティ値を定義し、アイテムがフォーカスを失ったことを示します。 | DataGridEvent |
columnIndex | プロパティ |
public var columnIndex:int
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
DataGrid オブジェクトの columns
配列の、イベントに関連付けられた列の 0 から始まるインデックスです。
dataField | プロパティ |
public var dataField:String
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
列に関連付けられているデータ内のフィールドまたはプロパティの名前です。
itemRenderer | プロパティ |
public var itemRenderer:IListItemRenderer
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
編集中のアイテムに対応するアイテムレンダラーか、クリックまたは展開されたヘッダーレンダラーです。 このプロパティを使用してデータプロバイダーアイテムにアクセスできます。
localX | プロパティ |
public var localX:Number
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
列の伸縮イベントを再生する場合の列の x 座標の位置です。
reason | プロパティ |
public var reason:String
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
itemEditEnd
イベントが送出された理由です。 タイプが ITEM_EDIT_END
のイベントに対してのみ有効です。 有効な値は、DataGridEventReason クラスに定義されています。
関連する API エレメント
rowIndex | プロパティ |
public var rowIndex:int
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
データプロバイダーのアイテムの 0 から始まるインデックスです。
DataGridEvent | () | コンストラクター |
public function DataGridEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, dataField:String = null, rowIndex:int = -1, reason:String = null, itemRenderer:IListItemRenderer = null, localX:Number = NaN)
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
コンストラクターです。通常は DataGrid オブジェクトによって呼び出されます。アプリケーションコードでは使用されません。
パラメーターtype:String — イベントタイプ。イベントの基となるアクションを示します。
| |
bubbles:Boolean (default = false ) — イベントが表示リスト階層を上方にバブルできるかどうかを指定します。
| |
cancelable:Boolean (default = false ) — イベントに関連付けられた動作をキャンセルできるかどうかを指定します。
| |
columnIndex:int (default = -1 ) — イベントが発生した列の 0 から始まるインデックスです。
| |
dataField:String (default = null ) — 列に関連付けられているデータ内のフィールドまたはプロパティの名前です。
| |
rowIndex:int (default = -1 ) — データプロバイダーのアイテムの 0 から始まるインデックスです。
| |
reason:String (default = null ) — itemEditEnd イベントの発生理由です。
| |
itemRenderer:IListItemRenderer (default = null ) — 編集中のアイテムレンダラーか、クリックされたヘッダーレンダラーです。
| |
localX:Number (default = NaN ) — columnStretch イベントを再生する場合の列の x 座標の位置です。
|
COLUMN_STRETCH | 定数 |
public static const COLUMN_STRETCH:String = "columnStretch"
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
DataGridEvent.COLUMN_STRETCH 定数は、イベントオブジェクトの type
プロパティ値を columnStretch
イベント用に定義し、ユーザーが列を水平方向に展開したことを示します。
イベントオブジェクトの各プロパティには次の値が設定されています。
プロパティ | 値 |
---|---|
bubbles | false |
cancelable | false |
columnIndex | DataGrid オブジェクトの columns 配列内のアイテムの列の 0 から始まるインデックスです。 |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は currentTarget となります。 |
dataField | 列に関連付けられているデータ内のフィールドまたはプロパティの名前です。 |
itemRenderer | null |
localX | マウスの x 座標です。 |
reason | null |
rowIndex | データプロバイダーのアイテムの 0 から始まるインデックスです。 |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。 イベントを受け取るオブジェクトに常にアクセスするには、currentTarget プロパティを使用してください。 |
type | DataGridEvent.COLUMN_STRETCH |
HEADER_RELEASE | 定数 |
public static const HEADER_RELEASE:String = "headerRelease"
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
DataGridEvent.HEADER_RELEASE 定数は、イベントオブジェクトの type
プロパティ値を headerRelease
イベント用に定義し、ユーザーが列ヘッダーの上でマウスを押して離したことを示します。
イベントオブジェクトの各プロパティには次の値が設定されています。
プロパティ | 値 |
---|---|
bubbles | false |
cancelable | true |
columnIndex | DataGrid オブジェクトの columns 配列内のアイテムの列の 0 から始まるインデックスです。 |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は currentTarget となります。 |
dataField | 列に関連付けられているデータ内のフィールドまたはプロパティの名前です。 |
itemRenderer | リリース中のヘッダーレンダラーです。 |
localX | NaN |
reason | null |
rowIndex | null |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。 イベントを受け取るオブジェクトに常にアクセスするには、currentTarget プロパティを使用してください。 |
type | DataGridEvent.HEADER_RELEASE |
ITEM_EDIT_BEGIN | 定数 |
public static const ITEM_EDIT_BEGIN:String = "itemEditBegin"
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
DataGridEvent.ITEM_EDIT_BEGIN 定数は、イベントオブジェクトの type
プロパティ値を itemEditBegin
イベント用に定義し、アイテムが編集可能であることを示します。
このイベントのデフォルトリスナーは、次のアクションを実行します。
createItemEditor()
メソッドの呼び出しを通じてアイテムエディターオブジェクトを作成します。data
プロパティをアイテムからエディターにコピーします。 デフォルトでは、アイテムエディターオブジェクトは、TextInput コントロールのインスタンスです。 リストコントロールのitemEditor
プロパティを使用して、独自のアイテムエディタークラスを指定します。- リストコントロールの
itemEditorInstance
プロパティを設定して、アイテムエディターインスタンスを参照するようにします。
このイベントのイベントリスナーを記述して、アイテムエディターに渡されるデータを変更できます。 例えば、データ、データのフォーマットなど、アイテムエディターで使用する情報を変更できます。
イベントリスナーを作成して、アイテムの編集に使用するアイテムエディターを指定することもできます。 例えば、2 つの異なるアイテムエディターがあるとします。 イベントリスナー内で編集するデータまたは他の情報を調べ、以下の手順に従って適切なアイテムエディターを開くことができます。
preventDefault()
を呼び出すと、createItemEditor()
メソッドがデフォルトイベントリスナーの一部として呼び出されることを阻止できます。itemEditor
プロパティに適切なエディターを設定します。createItemEditor()
メソッドを呼び出します。
イベントオブジェクトの各プロパティには次の値が設定されています。
プロパティ | 値 |
---|---|
bubbles | false |
cancelable | true |
columnIndex | DataGrid オブジェクトの columns 配列内のアイテムの列の 0 から始まるインデックスです。 |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は currentTarget となります。 |
dataField | null |
itemRenderer | 編集中のアイテムに対応するアイテムレンダラーです。 |
localX | NaN |
reason | null |
rowIndex | データプロバイダーのアイテムの 0 から始まるインデックスです。 |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。 イベントを受け取るオブジェクトに常にアクセスするには、currentTarget プロパティを使用してください。 |
type | DataGridEvent.ITEM_EDIT_BEGIN |
ITEM_EDIT_BEGINNING | 定数 |
public static const ITEM_EDIT_BEGINNING:String = "itemEditBeginning"
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
DataGridEvent.ITEM__EDIT_BEGINNING 定数は、イベントオブジェクトの type
プロパティ値を itemEditBeginning
イベント用に定義し、ユーザーがアイテム上でマウスボタンを離すなどの操作によってアイテムを編集できる状態にあることを示します。
このイベントのデフォルトリスナーによって、DataGrid.editedItemPosition
プロパティがフォーカスを持つアイテムに設定されて、アイテムの編集セッションが開始されます。
通常は、このイベントに対する独自のイベントリスナーを記述して、特定のアイテムを編集できないようにします。 このイベントの独自のイベントリスナー内から preventDefault()
メソッドを呼び出すことによって、デフォルトリスナーの実行が阻止されます。
イベントオブジェクトの各プロパティには次の値が設定されています。
プロパティ | 値 |
---|---|
bubbles | false |
cancelable | true |
columnIndex | DataGrid オブジェクトの columns 配列内のアイテムの列の 0 から始まるインデックスです。 |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は currentTarget となります。 |
dataField | アイテムの列に関連付けられているデータ内のフィールドまたはプロパティの名前です。 |
itemRenderer | 編集対象のアイテムに対応するアイテムレンダラーです。 このイベントがキーボードから生成された場合は、編集するアイテムが画面外である可能性があるため、このプロパティは null です。 |
localX | NaN |
reason | null |
rowIndex | データプロバイダーのアイテムの 0 から始まるインデックスです。 |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。 イベントを受け取るオブジェクトに常にアクセスするには、currentTarget プロパティを使用してください。 |
type | DataGridEvent.ITEM_EDIT_BEGINNING |
ITEM_EDIT_END | 定数 |
public static const ITEM_EDIT_END:String = "itemEditEnd"
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
DataGridEvent.ITEM_EDIT_END 定数は、イベントオブジェクトの type
プロパティ値を itemEditEnd
イベント用に定義し、編集セッションが終了することを示します。
List コンポーネントには、このイベントのデフォルトハンドラーがあり、アイテムエディターから List コントロールのデータプロバイダーにデータをコピーします。 デフォルトのイベントリスナーは、次のアクションを実行します。
- このイベントに関連付けられた DataGridColumn コントロールの
editorDataField
プロパティを使用して、新しいデータを含むアイテムエディターのプロパティを判別し、その新しいデータでデータプロバイダーアイテムを更新します。 デフォルトのアイテムエディターは TextInput コントロールであるため、editorDataField
プロパティのデフォルト値は"text"
であり、TextInput のtext
プロパティに新しいアイテムデータが含まれることを指定します。 destroyItemEditor()
メソッドを呼び出してアイテムエディターを閉じます。
通常は、このイベントのイベントリスナーを記述して、次のアクションを実行します。
- イベントリスナーで、エディターから List コンポーネントに返されたデータを変更できます。 例えば、List コントロールにデータを返す前に、データを再フォーマットできます。デフォルトでは、アイテムエディターは単一の値のみ返すことができます。 複数の値を返す場合は、
itemEditEnd
イベントのイベントリスナーを記述する必要があります。 - イベントリスナーでは、アイテムエディターに入力されたデータを確認できます。 データが正しくない場合は、
preventDefault()
メソッドを呼び出して、新しいデータが List コントロールに渡されないようにすることで、エディターが閉じることを阻止できます。
イベントオブジェクトの各プロパティには次の値が設定されています。
プロパティ | 値 |
---|---|
bubbles | false |
cancelable | true |
columnIndex | DataGrid オブジェクトの columns 配列内のアイテムの列の 0 から始まるインデックスです。 |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は currentTarget となります。 |
dataField | アイテムの列に関連付けられているデータ内のフィールドまたはプロパティの名前です。 |
itemRenderer | 編集中のアイテムに対応するアイテムレンダラーです。 |
localX | NaN |
reason | イベントの理由を定義する定数です。値は DataGridEventReason クラスのメンバーである必要があります。 |
rowIndex | データプロバイダーのアイテムの 0 から始まるインデックスです。 |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。 イベントを受け取るオブジェクトに常にアクセスするには、currentTarget プロパティを使用してください。 |
type | DataGridEvent.ITEM_EDIT_END |
ITEM_EDITOR_CREATE | 定数 |
public static const ITEM_EDITOR_CREATE:String = "itemEditorCreate"
DataGridEvent.ITEM_EDITOR_CREATE 定数は、イベントオブジェクトの type
プロパティ値を itemEditorCreate
イベント用に定義し、データグリッドでアイテムエディターの作成が完了したことを示します。
このイベントにはデフォルトのリスナーはありません。
ユーザーが編集を開始する前にこのイベントで itemEditor
に対する独自の変更を許可する場合、通常は、このイベント用に独自のイベントリスナーを作成します。
イベントオブジェクトの各プロパティには次の値が設定されています。
プロパティ | 値 |
---|---|
bubbles | false |
cancelable | true |
columnIndex | DataGrid オブジェクトの columns 配列内のアイテムの列の 0 から始まるインデックスです。 |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は currentTarget となります。 |
dataField | null |
itemRenderer | null |
localX | NaN |
reason | null |
rowIndex | データプロバイダーのアイテムの 0 から始まるインデックスです。 |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。 イベントを受け取るオブジェクトに常にアクセスするには、currentTarget プロパティを使用してください。 |
type | DataGridEvent.ITEM_EDITOR_CREATE |
ITEM_FOCUS_IN | 定数 |
public static const ITEM_FOCUS_IN:String = "itemFocusIn"
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
DataGridEvent.ITEM_FOCUS_IN 定数は、イベントオブジェクトの type
プロパティ値を itemFocusIn
イベント用に定義し、アイテムがフォーカスを受け取ったことを示します。
イベントオブジェクトの各プロパティには次の値が設定されています。
プロパティ | 値 |
---|---|
bubbles | false |
cancelable | false |
columnIndex | DataGrid オブジェクトの columns 配列内のアイテムの列の 0 から始まるインデックスです。 |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は currentTarget となります。 |
dataField | null |
itemRenderer | 編集中のアイテムに対応するアイテムエディターインスタンスです。 |
localX | NaN |
reason | null |
rowIndex | データプロバイダーのアイテムの 0 から始まるインデックスです。 |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。 イベントを受け取るオブジェクトに常にアクセスするには、currentTarget プロパティを使用してください。 |
type | DataGridEvent.ITEM_FOCUS_IN |
ITEM_FOCUS_OUT | 定数 |
public static const ITEM_FOCUS_OUT:String = "itemFocusOut"
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
DataGridEvent.ITEM_FOCUS_OUT 定数は、イベントオブジェクトの type
プロパティ値を itemFocusOut
イベント用に定義し、アイテムがフォーカスを失ったことを示します。
イベントオブジェクトの各プロパティには次の値が設定されています。
プロパティ | 値 |
---|---|
bubbles | false |
cancelable | false |
columnIndex | DataGrid オブジェクトの columns 配列内のアイテムの列の 0 から始まるインデックスです。 |
currentTarget | イベント処理を行うイベントリスナーの定義用オブジェクトを表します。 例えば、イベントリスナーの登録に myButton.addEventListener() を使用すると、myButton の値は currentTarget となります。 |
dataField | null |
itemRenderer | 編集中のアイテムに対応するアイテムエディターインスタンスです。 |
localX | NaN |
reason | null |
rowIndex | データプロバイダーのアイテムの 0 から始まるインデックスです。 |
target | イベントを送出したオブジェクトを表します。このオブジェクトは必ずしもイベントを受け取るオブジェクトとは限りません。 イベントを受け取るオブジェクトに常にアクセスするには、currentTarget プロパティを使用してください。 |
type | DataGridEvent.ITEM_FOCUS_OUT |
Tue Jun 12 2018, 10:34 AM Z