パッケージfl.controls
クラスpublic class DataGrid
継承DataGrid Inheritance SelectableList Inheritance BaseScrollPane Inheritance UIComponent Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
実装 IFocusManagerComponent

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

DataGrid クラスは、行と列のグリッドを提供するリストベースのコンポーネントです。コンポーネントの上部にすべてのプロパティ名を示すオプションのヘッダ行を指定できます。各行は、1 つまたは複数の列で構成され、各列は、指定されたデータオブジェクトに属するプロパティを表します。DataGrid コンポーネントはデータを表示するために使用され、HTML テーブルのようなレイアウトツールとしての使用は想定されていません。

DataGrid コンポーネントは、複数のプロパティを含むオブジェクトの表示に適しています。DataGrid コンポーネントが表示できるデータは、DataProvider オブジェクトかオブジェクトの配列として含まれているデータです。DataGrid コンポーネントの列は、DataGridColumn オブジェクトのリストで表すことができます。各オブジェクトには、列に固有の情報が含まれています。

DataGrid コンポーネントは次の機能を提供します。

DataGrid コンポーネントは、ScrollBar コンポーネント、HeaderRenderer コンポーネント、CellRenderer コンポーネント、DataGridCellEditor コンポーネント、ColumnDivider コンポーネントなどのサブコンポーネントで構成されます。これらのすべては、オーサリング時や実行時にスキンを使用できます。

DataGrid コンポーネントは、dataGridClasses パッケージで検索できる次のクラスを使用します。

例を表示

関連項目

DataGridCellEditor
DataGridColumn
HeaderRenderer
CellRenderer
DataGridEvent


パブリック プロパティ
 プロパティ定義元
 InheritedaccessibilityProperties : AccessibilityProperties
この表示オブジェクトの現在のアクセシビリティオプションです。
DisplayObject
 InheritedallowMultipleSelection : Boolean
複数のリストアイテムを一度に選択できるかどうかを示すブール値を取得します。
SelectableList
 Inheritedalpha : Number
指定されたオブジェクトのアルファ透明度値を示します。
DisplayObject
 InheritedblendMode : String
使用するブレンドモードを指定する BlendMode クラスの値です。
DisplayObject
 InheritedbuttonMode : Boolean
このスプライトのボタンモードを指定します。
Sprite
 InheritedcacheAsBitmap : Boolean
true に設定されている場合、表示オブジェクトの内部ビットマップ表現が Flash Player にキャッシュされます。
DisplayObject
  columns : Array
表示可能なそれぞれの列に対応した DataGridColumn オブジェクトの配列を取得または設定します。
DataGrid
 Inheritedconstructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 InheritedcontextMenu : ContextMenu
このオブジェクトに関連付けられたコンテキストメニューを指定します。
InteractiveObject
 InheriteddataProvider : DataProvider
表示されるアイテムのリストのデータモデルを取得または設定します。
SelectableList
 InheriteddoubleClickEnabled : Boolean
オブジェクトが doubleClick イベントを受け取るかどうかを指定します。
InteractiveObject
 InheriteddropTarget : DisplayObject
[read-only] スプライトのドラッグ先またはスプライトがドロップされた先の表示オブジェクトを指定します。
Sprite
  editable : Boolean = false
データプロバイダ内のアイテムをユーザーが編集できるかどうかを示します。
DataGrid
  editedItemPosition : Object
編集中のデータプロバイダアイテムのアイテムレンダラーの列と行のインデックスを取得または設定します。
DataGrid
  editedItemRenderer : ICellRenderer
[read-only] 編集中のアイテムが位置する DataGrid コンポーネント内のアイテムレンダラーへの参照を取得します。
DataGrid
 Inheritedenabled : Boolean
コンポーネントがユーザーの操作を受け付けるかどうかを示す値を取得または設定します。
UIComponent
 Inheritedfilters : Array
表示オブジェクトに現在関連付けられている各フィルタオブジェクトが格納されているインデックス付きの配列です。
DisplayObject
 InheritedfocusEnabled : Boolean
ユーザーがコンポーネントをクリックしたときに、コンポーネントがフォーカスを受け取ることが可能かどうかを示すブール値を取得または設定します。
UIComponent
 InheritedfocusManager : IFocusManager
このコンポーネントとそのピアーに対するフォーカスを制御する FocusManager を取得または設定します。
UIComponent
 InheritedfocusRect : Object
このオブジェクトがフォーカス矩形を表示するかどうかを指定します。
InteractiveObject
 Inheritedgraphics : Graphics
[read-only] ベクターの描画コマンドが発生する、このスプライトに属する Graphics オブジェクトを指定します。
Sprite
  headerHeight : Number
DataGrid ヘッダの高さ (ピクセル単位) を取得または設定します。
DataGrid
 Inheritedheight : Number
コンポーネントの高さを取得または設定します (ピクセル単位)。
UIComponent
 InheritedhitArea : Sprite
スプライトのヒット領域となる別のスプライトを指定します。
Sprite
 InheritedhorizontalLineScrollSize : Number
スクロール矢印ボタンをクリックしたときにコンテンツが水平方向にスクロールする移動量を取得または設定します。
BaseScrollPane
 InheritedhorizontalPageScrollSize : Number
水平スクロールバーのトラックがクリックされたときにスクロールサムが移動するピクセル数を取得また設定します。
BaseScrollPane
 InheritedhorizontalScrollBar : ScrollBar
[read-only] 水平スクロールバーへの参照を取得します。
BaseScrollPane
  horizontalScrollPolicy : String
水平スクロールバーが常にオンであるかどうかを示すブール値を取得または設定します。
DataGrid
 InheritedhorizontalScrollPosition : Number
スクロールパネル内での水平スクロールバーの位置をピクセル単位で示す値を取得または設定します。
BaseScrollPane
  imeMode : String
入力メソッドエディタ (IME) のモードを取得または設定します。
DataGrid
  itemEditorInstance : Object
現在アクティブなアイテムエディタのインスタンスへの参照です (存在する場合)。
DataGrid
  labelFunction : Function
ラベルテキストとして使用する各アイテムのフィールドを特定する関数を取得または設定します。
DataGrid
 Inheritedlength : uint
[read-only] データプロバイダに含まれているアイテムの数を取得します。
SelectableList
 InheritedloaderInfo : LoaderInfo
[read-only] この表示オブジェクトが属するファイルのロード情報を含む LoaderInfo オブジェクトを返します。
DisplayObject
 Inheritedmask : DisplayObject
呼び出し元の表示オブジェクトは、指定された mask オブジェクトによってマスクされます。
DisplayObject
 InheritedmaxHorizontalScrollPosition : Number
horizontalScrollPolicy プロパティが ScrollPolicy.ON に設定されているときに、リストを右方向にスクロールするピクセル数を取得または設定します。
SelectableList
 InheritedmaxVerticalScrollPosition : Number
[read-only] 現在のコンテンツの垂直スクロール位置の最大値 (ピクセル単位) を取得します。
BaseScrollPane
  minColumnWidth : Number
DataGrid 列の最小幅 (ピクセル単位) を取得または設定します。
DataGrid
 InheritedmouseChildren : Boolean
オブジェクトの子に対してマウスが有効かどうかを調べます。
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
このオブジェクトがマウスメッセージを受け取るかどうかを指定します。
InteractiveObject
 InheritedmouseFocusEnabled : Boolean
ユーザーがコンポーネントをクリックしたときに、コンポーネントがフォーカスを受け取ることが可能かどうかを示す値を取得または設定します。
UIComponent
 InheritedmouseX : Number
[read-only] マウス位置の x 座標を示します (ピクセル単位)。
DisplayObject
 InheritedmouseY : Number
[read-only] マウス位置の y 座標を示します (ピクセル単位)。
DisplayObject
 Inheritedname : String
DisplayObject のインスタンス名を示します。
DisplayObject
 InheritednumChildren : int
[read-only] このオブジェクトの子の数を返します。
DisplayObjectContainer
 InheritedopaqueBackground : Object
表示オブジェクトが特定の背景色で不透明であるかどうかを指定します。
DisplayObject
 Inheritedparent : DisplayObjectContainer
[read-only] この表示オブジェクトを含む DisplayObjectContainer オブジェクトを示します。
DisplayObject
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  resizableColumns : Boolean = true
ユーザーが列のサイズを変更できるかどうかを示します。
DataGrid
 Inheritedroot : DisplayObject
[read-only] ロードされた SWF ファイル内の表示オブジェクトの場合、root プロパティはその SWF ファイルが表す表示リストのツリー構造部分の一番上にある表示オブジェクトとなります。
DisplayObject
 Inheritedrotation : Number
DisplayObject インスタンスの元の位置からの回転角を度単位で示します。
DisplayObject
  rowCount : uint
リスト内に少なくとも部分的に表示される行数を取得または設定します。
DataGrid
  rowHeight : Number
DataGrid コンポーネント内の各行の高さを取得または設定します (ピクセル単位)。
DataGrid
 Inheritedscale9Grid : Rectangle
現在有効な拡大 / 縮小グリッドです。
DisplayObject
 InheritedscaleX : Number
コンポーネントの現在の幅に縮尺率を乗算します。
UIComponent
 InheritedscaleY : Number
コンポーネントの現在の高さに縮尺率を乗算します。
UIComponent
 InheritedscrollRect : Rectangle
表示オブジェクトのスクロール矩形の境界です。
DisplayObject
 Inheritedselectable : Boolean
リスト内のアイテムを選択できるかどうかを示すブール値を取得または設定します。
SelectableList
 InheritedselectedIndex : int
単一選択リストで選択されたアイテムのインデックスを取得または設定します。
SelectableList
 InheritedselectedIndices : Array
複数選択リストから選択されたアイテムを含む配列を取得または設定します。
SelectableList
 InheritedselectedItem : Object
単一選択リストから選択されたアイテムを取得または設定します。
SelectableList
 InheritedselectedItems : Array
複数選択リストから選択されたアイテムのオブジェクトを含む配列を取得または設定します。
SelectableList
  showHeaders : Boolean
DataGrid コンポーネントに列ヘッダが表示されるかどうかを示すブール値を取得または設定します。
DataGrid
  sortableColumns : Boolean = true
ユーザーが列ヘッダセルをクリックして、データプロバイダ内のアイテムを並べ替えることができるかどうかを示します。
DataGrid
  sortDescending : Boolean
[read-only] ユーザーが列のヘッダをクリックしたときに、列が並べ替えられる順序を取得します。
DataGrid
  sortIndex : int
[read-only] 並べ替える列のインデックスを取得します。
DataGrid
 InheritedsoundTransform : SoundTransform
このスプライト内のサウンドを制御します。
Sprite
 Inheritedstage : Stage
[read-only] 表示オブジェクトのステージです。
DisplayObject
 InheritedtabChildren : Boolean
オブジェクトの子に対してタブが有効かどうかを調べます。
DisplayObjectContainer
 InheritedtabEnabled : Boolean
このオブジェクトがタブ順序に含まれるかどうかを指定します。
InteractiveObject
 InheritedtabIndex : int
SWF ファイル内のオブジェクトのタブ順序を指定します。
InteractiveObject
 InheritedtextSnapshot : TextSnapshot
[read-only] この DisplayObjectContainer インスタンスの TextSnapshot オブジェクトを返します。
DisplayObjectContainer
 Inheritedtransform : Transform
表示オブジェクトのマトリックス、カラー変換、ピクセル境界に関係するプロパティを持つオブジェクトです。
DisplayObject
 InheriteduseBitmapScrolling : Boolean
true に設定すると、cacheAsBitmap プロパティによるコンテンツのスクロールが true に設定されます。false に設定すると、この値はオフになります。
BaseScrollPane
 InheriteduseHandCursor : Boolean
buttonMode プロパティが true に設定されたスプライト上にマウスが移動したときに、指差しハンドポインタ (ハンドカーソル) を表示するかどうかを示すブール値です。
Sprite
 Inheritedversion : String = "3.0.0.15"
コンポーネントのバージョン番号。
UIComponent
 InheritedverticalLineScrollSize : Number
スクロール矢印ボタンをクリックしたときにコンテンツが垂直方向にスクロールするピクセル数を取得または設定します。
BaseScrollPane
 InheritedverticalPageScrollSize : Number
垂直スクロールバーのトラックがクリックされたときにスクロールサムが移動するピクセル数を取得また設定します。
BaseScrollPane
 InheritedverticalScrollBar : ScrollBar
[read-only] 垂直スクロールバーへの参照を取得します。
BaseScrollPane
 InheritedverticalScrollPolicy : String
垂直スクロールバーの状態を示す値を取得または設定します。
BaseScrollPane
 InheritedverticalScrollPosition : Number
スクロールパネル内での垂直スクロールバーの位置をピクセル単位で示す値を取得または設定します。
BaseScrollPane
 Inheritedvisible : Boolean
現在のコンポーネントのインスタンスが可視かどうかを示す値を取得または設定します。
UIComponent
 Inheritedwidth : Number
コンポーネントの幅を取得または設定します (ピクセル単位)。
UIComponent
 Inheritedx : Number
親コンテナ内での x 軸に沿ったコンポーネントの位置を表す x 座標を取得または設定します。
UIComponent
 Inheritedy : Number
親コンテナ内での y 軸に沿ったコンポーネントの位置を表す y 座標を取得または設定します。
UIComponent
パブリック メソッド
 メソッド定義元
  
DataGrid コンポーネントの新しいインスタンスを作成します。
DataGrid
 Inherited
この DisplayObjectContainer インスタンスに子 DisplayObject インスタンスを追加します。
DisplayObjectContainer
 Inherited
この DisplayObjectContainer インスタンスに子 DisplayObject インスタンスを追加します。
DisplayObjectContainer
  
columns 配列の末尾に列を追加します。
DataGrid
  
addColumnAt(column:*, index:uint):DataGridColumn
columns 配列の指定したインデックス位置に列を挿入します。
DataGrid
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
 Inherited
アイテムのリストの末尾にアイテムを追加します。
SelectableList
 Inherited
addItemAt(item:Object, index:uint):void
指定されたインデックス位置のリストにアイテムを挿入します。
SelectableList
 Inherited
特定の point ポイントを指定して呼び出した DisplayObjectContainer.getObjectsUnderPoint() メソッドから返されたリストに、セキュリティ上の制約のために省略される表示オブジェクトがあるかどうかを示します。
DisplayObjectContainer
 Inherited
clearRendererStyle(name:String, column:int = -1):void
リスト内のレンダラーに設定されたスタイルをクリアします。
SelectableList
 Inherited
リスト内で現在選択されているアイテムをクリアし、selectedIndex プロパティを -1 に設定します。
SelectableList
 Inherited
このコンポーネントインスタンスからスタイルプロパティを削除します。
UIComponent
 Inherited
指定された表示オブジェクトが、DisplayObjectContainer インスタンスの子であるか、インスタンス自体であるかを指定します。
DisplayObjectContainer
  
createItemEditor(colIndex:uint, rowIndex:uint):void
itemEditor プロパティによって指定されたエディタを使用して、editedItemPosition プロパティによって識別される列と行のインデックスにアイテムレンダラーのアイテムエディタを作成します。
DataGrid
  
アイテムレンダラーに対して現在開かれているアイテムエディタを閉じます。
DataGrid
 Inherited
イベントをイベントフローに送出します。
EventDispatcher
 Inherited
このコンポーネントのフォーカスインジケータを表示または非表示にします。
UIComponent
 Inherited
invalidateNow とは異なり、すべてを無効化せずに直ちに描画を開始します。
UIComponent
  
editField(index:uint, dataField:String, data:Object):void
DataGrid コンポーネント内の指定されたフィールドまたはプロパティを編集します。
DataGrid
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
targetCoordinateSpace オブジェクトの座標系を基準にして、表示オブジェクトの領域を定義する矩形を返します。
DisplayObject
  
DataGrid 内の指定された位置にあるセルレンダラーのインスタンスを取得します。
DataGrid
 Inherited
指定のインデックス位置にある子表示オブジェクトインスタンスを返します。
DisplayObjectContainer
 Inherited
指定された名前に一致する子表示オブジェクトを返します。
DisplayObjectContainer
 Inherited
子 DisplayObject インスタンスのインデックス位置を返します。
DisplayObjectContainer
  
columns 配列の指定されたインデックスの位置にある列を取得します。
DataGrid
  
DataGrid コンポーネント内にある列の数を取得します。
DataGrid
  
指定された名前の列のインデックスを取得します。一致しなかった場合は、-1 を取得します。
DataGrid
 Inherited
現在フォーカスを持っているオブジェクトを取得します。
UIComponent
 Inherited
指定されたインデックス位置のアイテムを取得します。
SelectableList
 Inherited
getNextIndexAtLetter(firstLetter:String, startIndex:int = -1):int
dataProvider 内で、ラベルの最初の文字が指定した文字に一致するアイテムの次のアイテムのインデックスを返します。
SelectableList
 Inherited
指定されたポイントの下にあり、この DisplayObjectContainer インスタンスの子または孫などであるオブジェクトの配列を返します。
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
シェイプ上の線を除き、targetCoordinateSpace パラメータによって定義された座標系に基づいて、表示オブジェクトの境界を定義する矩形を返します。
DisplayObject
 Inherited
getRendererStyle(name:String, column:int = -1):Object
リスト内のレンダラーに設定されるスタイルを取得します。
SelectableList
 Inherited
コンポーネントのスタイル参照チェーンに設定されているスタイルプロパティを取得します。
UIComponent
  
[static] 現在のコンポーネントのデフォルトスタイルマップを取得します。
DataGrid
 Inherited
point オブジェクトをステージ (グローバル) 座標から表示オブジェクトの (ローカル) 座標に変換します。
DisplayObject
 Inherited
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
表示オブジェクトを評価して、obj 表示オブジェクトと重複または交差するかどうかを調べます。
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
表示オブジェクトを評価して、x および y パラメータで指定されたポイントと重複または交差するかどうかを調べます。
DisplayObject
 Inherited
invalidate(property:String, callLater:Boolean = true):void
プロパティが無効であることを示し、指定がない限り、コンポーネントを次のフレームに再描画します。
UIComponent
 Inherited
特定のアイテムレンダラーを無効化します。
SelectableList
 Inherited
指定のインデックス位置にあるアイテムのレンダラーを無効化します。
SelectableList
 Inherited
リスト全体を無効化し、リストアイテムを強制的に再描画します。
SelectableList
 Inherited
指定されたアイテムがリストで選択されているかどうかを確認します。
SelectableList
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
  
DataGrid コンポーネントは、特定のアイテムに対して複数のセルを持つため、itemToCellRenderer メソッドは常に
DataGrid
 Inherited
オブジェクトの label プロパティに基づいて、指定されたデータオブジェクトに対してレンダラーが表示するストリングを取得します。
SelectableList
 Inherited
point オブジェクトを表示オブジェクトの (ローカル) 座標からステージ (グローバル) 座標に変換します。
DisplayObject
 Inherited
[static] 複数のクラスのスタイルを 1 つのオブジェクトに結合します。
UIComponent
 Inherited
親の内部の指定された位置にコンポーネントを移動します。
UIComponent
 Inherited
指定されたプロパティが存在し列挙できるかどうかを示します。
Object
 Inherited
リストからすべてのアイテムを削除します。
SelectableList
  
DataGrid コンポーネントからすべての列を削除します。
DataGrid
 Inherited
DisplayObjectContainer インスタンスの子リストから指定の child DisplayObject インスタンスを削除します。
DisplayObjectContainer
 Inherited
DisplayObjectContainer の子リストの指定されたインデックス位置から子 DisplayObject を削除します。
DisplayObjectContainer
  
columns 配列の指定されたインデックスの位置にある列を削除します。
DataGrid
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 Inherited
指定されたアイテムをリストから削除します。
SelectableList
 Inherited
指定したインデックス位置のアイテムを削除します。
SelectableList
 Inherited
指定されたインデックス位置にあるアイテムを別のアイテムで置き換えます。
SelectableList
  
scrollToIndex(newCaretIndex:int):void
指定されたインデックス位置にあるアイテムまでリストをスクロールします。
DataGrid
 Inherited
selectedIndex プロパティの現在の値で示される位置にあるアイテムまでリストをスクロールします。
SelectableList
 Inherited
表示オブジェクトコンテナの既存の子の位置を変更します。
DisplayObjectContainer
 Inherited
現在扱っているコンポーネントにフォーカスを設定します。
UIComponent
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
setRendererStyle(name:String, style:Object, column:uint = 0):void
リスト内のレンダラーにスタイルを設定します。
SelectableList
 Inherited
setSize(width:Number, height:Number):void
コンポーネントのサイズを、指定した幅と高さに設定します。
UIComponent
 Inherited
setStyle(style:String, value:Object):void
このコンポーネントインスタンスのスタイルプロパティを設定します。
UIComponent
 Inherited
sortItems(... sortArgs):*
現在のデータプロバイダのエレメントを並べ替えます。
SelectableList
 Inherited
sortItemsOn(field:String, options:Object = null):*
現在のデータプロバイダのエレメントを 1 つまたは複数のフィールドで並べ替えます。
SelectableList
  
表示可能な列の幅を同じサイズにリセットします。
DataGrid
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
指定されたスプライトをユーザーがドラッグできるようにします。
Sprite
 Inherited
startDrag() メソッドを終了します。
Sprite
 Inherited
指定された 2 つの子オブジェクトの z 順序 (重ね順) を入れ替えます。
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
子リスト内の指定されたインデックス位置に該当する 2 つの子オブジェクトの z 順序 (重ね順) を入れ替えます。
DisplayObjectContainer
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
必要に応じて、このオブジェクトのプロパティとレイアウトを検証および更新し、それを再描画します。
UIComponent
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
イベント
 イベント 概要 定義元
 Inherited Flash Player がオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited 表示オブジェクトが表示リストに追加されたときに送出されます。DisplayObject
 Inherited 表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの追加により、ステージ上の表示リストに追加されたときに送出されます。DisplayObject
 Inherited リストで別のアイテムが選択されたときに送出されます。SelectableList
 Inherited ユーザーが InteractiveObject をポインティングデバイスのメインボタンでクリックしたときに送出されます。InteractiveObject
   ユーザーが列を横方向に拡張した後に送出されます。DataGrid
 Inherited Flash Player がオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
 Inherited オブジェクトの doubleClickEnabled フラグが true に設定されている場合にユーザーが InteractiveObject をポインティングデバイスのメインボタンで 2 回続けてすばやくクリックすると送出されます。InteractiveObject
 Inherited 再生ヘッドが新しいフレームに入るときに送出されます。DisplayObject
 Inherited 表示オブジェクトがフォーカスを取得したときに送出されます。InteractiveObject
 Inherited 表示オブジェクトがフォーカスを失ったときに送出されます。InteractiveObject
   ユーザーがヘッダセルをクリックした後に送出されます。DataGrid
 Inherited コンポーネントの可視性が可視から不可視に変化した後に送出されます。UIComponent
 Inherited ユーザーがコンポーネント内のアイテムをクリックしたときに送出されます。SelectableList
 Inherited ユーザーがコンポーネント内のアイテムを連続してすばやく 2 回クリックしたときに送出されます。SelectableList
   editedItemPosition プロパティが設定され、アイテムが編集可能になった後に送出されます。DataGrid
   ユーザーがアイテム上でマウスボタンを離したときなど、アイテムを編集する準備を行った後に送出されます。DataGrid
   何らかの理由でアイテム編集セッションが終了するときに送出されます。DataGrid
   アイテムがフォーカスを受け付けた後に送出されます。DataGrid
   アイテムがフォーカスを失った後に送出されます。DataGrid
 Inherited ユーザーがコンポーネント内のアイテムからポインタを離したときに送出されます。SelectableList
 Inherited ユーザーがコンポーネント内のアイテムにポインタを置いたときに送出されます。SelectableList
 Inherited ユーザーがキーを押したときに送出されます。InteractiveObject
 Inherited ユーザーがキーボード操作によってフォーカスを変更しようとすると送出されます。InteractiveObject
 Inherited ユーザーがキーを離したときに送出されます。InteractiveObject
 Inherited Flash Player ウィンドウの InteractiveObject インスタンスの上でユーザーがポインティングデバイスのボタンを押すと送出されます。InteractiveObject
 Inherited ユーザーがポインティングデバイスでフォーカスを変更しようとすると送出されます。InteractiveObject
 Inherited ユーザーが InteractiveObject の上でポインティングデバイスを移動させたときに送出されます。InteractiveObject
 Inherited ユーザーが InteractiveObject インスタンスからポインティングデバイスを離したときに送出されます。InteractiveObject
 Inherited ユーザーが Flash Player ウィンドウの InteractiveObject インスタンスにポインティングデバイスを合わせたときに送出されます。InteractiveObject
 Inherited ユーザーが Flash Player ウィンドウの InteractiveObject インスタンスの上でポインティングデバイスのボタンを解放したときに送出されます。InteractiveObject
 Inherited Flash Player ウィンドウの InteractiveObject インスタンスの上でマウスホイールを回転させたときに送出されます。InteractiveObject
 Inherited コンポーネントが移動された後に送出されます。UIComponent
 Inherited 表示オブジェクトが表示リストから削除されようとしているときに送出されます。DisplayObject
 Inherited 表示オブジェクトが、直接、または表示オブジェクトを含むサブツリーの削除により、表示リストから削除されようとしているときに送出されます。DisplayObject
 Inherited 表示リストが更新およびレンダリングされようとしているときに送出されます。DisplayObject
 Inherited コンポーネントのサイズが変更された後に送出されます。UIComponent
 Inherited ユーザーがコンポーネントからポインタを離したときに送出されます。SelectableList
 Inherited ユーザーがコンポーネント上にマウスポインタを移動させたときに送出されます。SelectableList
 Inherited ユーザーが水平方向または垂直方向にスクロールしたときに送出されます。SelectableList
 Inherited コンポーネントの可視性が不可視から可視に変化した後に送出されます。UIComponent
 Inherited オブジェクトの tabChildren フラグの値が変更されたときに送出されます。InteractiveObject
 Inherited オブジェクトの tabEnabled フラグが変更されたときに送出されます。InteractiveObject
 Inherited オブジェクトの tabIndex プロパティの値が変更されたときに送出されます。InteractiveObject
スタイル
 スタイル 説明 定義元
 Inherited データ型: Class
コンポーネント内の各アイテム用のセルレンダラーを指定するクラスです。
SelectableList
  
columnDividerSkin
データ型: Class
列間に表示される区切りを指定するクラスの名前です。 デフォルト値 : DataGrid_columnDividerSkin.
DataGrid
  
columnStretchCursorSkin
データ型: Class
カーソルが 2 つの列ヘッダ間にあり、resizableColumns プロパティが true に設定されている場合に使用されるカーソルを指定するクラスの名前です。 デフォルト値 : DataGrid_columnStretchCursorSkin.
DataGrid
 Inherited データ型: Number   形式: Length
リストとリストのコンテンツを区切るパディングです (ピクセル単位)。
SelectableList
 Inherited データ型: Number
enabled プロパティが false の場合に、リストに設定されるアルファの値です。
SelectableList
 Inherited データ型: flash.text.TextFormat
ボタンが無効な場合に、コンポーネントラベルのレンダリングに使用される TextFormat オブジェクトです。
UIComponent
 Inherited データ型: Class
スクロールバーの下矢印ボタンが無効になったときに、その下矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。
BaseScrollPane
 Inherited データ型: Class
スクロールバーの下矢印ボタンをクリックしたときに、その下矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。
BaseScrollPane
 Inherited データ型: Class
スクロールバーの下矢印ボタンにマウスポインタを合わせたときに、その下矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。
BaseScrollPane
 Inherited データ型: Class
スクロールバーの下矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。
BaseScrollPane
 Inherited データ型: Number   形式: Length
コンポーネント領域の外側とフォーカスインジケータ領域のエッジを区切るパディングです (ピクセル単位)。
UIComponent
 Inherited データ型: Class
フォーカスインジケータの表示に使用されるスキンです。
UIComponent
  
headerDisabledSkin
データ型: Class
コンポーネントが無効な場合に、各列ヘッダの背景を指定するクラスの名前です。 デフォルト値 : HeaderRenderer_disabledSkin.
DataGrid
  
headerDisabledTextFormat
データ型: flash.text.TextFormat
コンポーネントが無効な場合に、各列ヘッダに含まれるテキストに適用されるフォーマットです。 デフォルト値 : null.
DataGrid
  
headerDownSkin
データ型: Class
マウスボタンがダウン状態の場合に、各列ヘッダの背景を指定するクラスの名前です。 デフォルト値 : HeaderRenderer_downSkin.
DataGrid
  
headerOverSkin
データ型: Class
カーソルが列ヘッダの上にある場合に、各列ヘッダの背景を指定するクラスの名前です。 デフォルト値 : HeaderRenderer_overSkin.
DataGrid
  
headerRenderer
データ型: Class
各列ヘッダを指定するクラスの名前です。 デフォルト値 : fl.controls.dataGridClasses.HeaderRenderer.
DataGrid
  
headerSortArrowAscSkin
データ型: Class
ソート列が昇順の場合に、ソート用の矢印を指定するクラスの名前です。 デフォルト値 : HeaderSortArrow_ascIcon.
DataGrid
  
headerSortArrowDescSkin
データ型: Class
ソート列が降順の場合に、ソート用の矢印を指定するクラスの名前です。 デフォルト値 : HeaderSortArrow_descIcon.
DataGrid
  
headerTextFormat
データ型: flash.text.TextFormat
各列ヘッダに含まれるテキストに適用されるフォーマットです。 デフォルト値 : null.
DataGrid
  
headerTextPadding
データ型: Number   形式: Length
列ヘッダの境界と列ヘッダのテキストを区切るパディングです (ピクセル単位)。 デフォルト値 : 5.
DataGrid
  
headerUpSkin
データ型: Class
各列ヘッダの背景を指定するクラスの名前です。 デフォルト値 : HeaderRenderer_upSkin.
DataGrid
 Inherited データ型: Number   形式: Time
buttonDown イベントが最初に送出されてから 2 番目の buttonDown イベントを送出するまでの待機時間です (ミリ秒単位)。
BaseScrollPane
 Inherited データ型: Number   形式: Time
buttonDown イベントを再送出するまでの待機時間を repeatDelay スタイルに指定します (ミリ秒単位)。
BaseScrollPane
 Inherited データ型: Class
コンポーネントの背景用のスキンを指定するクラスです。
SelectableList
 Inherited データ型: flash.text.TextFormat
コンポーネントラベルのレンダリングに使用される TextFormat オブジェクトです。
UIComponent
 Inherited データ型: Class
サムの無効状態を示すために使用されるスキンです。
BaseScrollPane
 Inherited データ型: Class
サムをクリックしたときに、スクロールバーのサムのスキンとして使用するクラスの名前です。
BaseScrollPane
 Inherited データ型: Class
スクロールバーのサムのアイコンとして使用するクラスの名前です。
BaseScrollPane
 Inherited データ型: Class
スクロールバーのサムにマウスポインタを合わせたときに、そのサムのスキンとして使用するクラスの名前です。
BaseScrollPane
 Inherited データ型: Class
スクロールバーのサムのスキンとして使用するクラスの名前です。
BaseScrollPane
 Inherited データ型: Class
無効なトラックを示すために使用されるスキンです。
BaseScrollPane
 Inherited データ型: Class
無効なスキンのダウン状態を示すために使用されるスキンです。
BaseScrollPane
 Inherited データ型: Class
スクロールトラック上にマウスが配置されていることを示すために使用されるスキンです。
BaseScrollPane
 Inherited データ型: Class
スクロールトラックのマウスのアップ状態を示すために使用されるスキンです。
BaseScrollPane
 Inherited データ型: Class
スクロールバーの上矢印ボタンが無効になったときに、その上矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。
BaseScrollPane
 Inherited データ型: Class
スクロールバーの上矢印ボタンをクリックしたときに、その上矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。
BaseScrollPane
 Inherited データ型: Class
スクロールバーの上矢印ボタンにマウスポインタを合わせたときに、その上矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。
BaseScrollPane
 Inherited データ型: Class
スクロールバーの上矢印ボタンのスキンとして使用するクラスの名前です。グラフィカルまたはプログラムのいずれかの方法でスキンを変更する場合は、新しいスキンの高さ (水平スクロールバーの場合) または幅 (垂直スクロールバーの場合) をトラックと同じにする必要があります。
BaseScrollPane
プロパティの詳細
columnsプロパティ
columns:Array  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

表示可能なそれぞれの列に対応した DataGridColumn オブジェクトの配列を取得または設定します。明示的に設定されていない場合、DataGrid コンポーネントは、データプロバイダの最初のアイテムを調べてそのプロパティを検索し、次に検索したプロパティをアルファベット順に表示します。

この DataGridColumn 配列の列とその順序を変更できます。ただし、変更を行った後に、変更された配列を columns プロパティに明示的に割り当てる必要があります。明示的な割り当てを行わない場合は、以前に使用された列のセットが引き続き使用されます。

デフォルト値 : [].


実装
    public function get columns():Array
    public function set columns(value:Array):void



次の例では、columns 配列を使用してデータグリッドに新しい列を追加します。

import fl.controls.DataGrid;
import fl.controls.ScrollPolicy;
import fl.data.DataProvider;

var i:uint;
var totalRows:uint = 16;
var dp:DataProvider = new DataProvider();
for (i = 0; i < totalRows; i++) {
    dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber()});
}

var dg:DataGrid = new DataGrid();
dg.setSize(200, 300);
dg.columns = ["col1", "col2", "col3"];
dg.dataProvider = dp;
addChild(dg);

function getRandomNumber():uint {
    return Math.round(Math.random() * 100);
}

次の例では、新しい DataGrid に列を挿入し、columns 配列と getColumnCount() メソッドを使用して列の数を返します。

import fl.controls.DataGrid;
import fl.controls.ScrollPolicy;
import fl.data.DataProvider;

var i:uint;
var totalRows:uint = 16;
var dp:DataProvider = new DataProvider();
for (i = 0; i < totalRows; i++) {
    dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber()});
}

var dg:DataGrid = new DataGrid();
dg.setSize(200, 300);
dg.columns = ["col1", "col2", "col3"];
dg.dataProvider = dp;
addChild(dg);

trace("columns.length:", dg.columns.length); // 3
trace("getColumnCount():", dg.getColumnCount()); // 3

function getRandomNumber():uint {
    return Math.round(Math.random() * 100);
}
editableプロパティ 
public var editable:Boolean = false

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

データプロバイダ内のアイテムをユーザーが編集できるかどうかを示します。true の値は、ユーザーがデータプロバイダ内のアイテムを編集できることを示します。false の値は、ユーザーが編集できないことを示します。

この値が true の場合、コンポーネント内のアイテムレンダラーは編集可能です。ユーザーは、アイテムレンダラーをクリックすることでエディタを開くことができます。

DataGrid コンポーネントに含まれる個々の列の編集をオフにするには、DataGridColumn.editable プロパティを使用するか、または itemEditBeginning イベントと itemEditBegin イベントを処理します。

デフォルト値 : false.

関連項目

editedItemPositionプロパティ 
editedItemPosition:Object  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

編集中のデータプロバイダアイテムのアイテムレンダラーの列と行のインデックスを取得または設定します。編集中のアイテムがない場合、このプロパティは null です。

このオブジェクトには、次の 2 つのフィールドがあります。

次に例を示します。{ columnIndex:2, rowIndex:3 }

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

デフォルト値 : null.


実装
    public function get editedItemPosition():Object
    public function set editedItemPosition(value:Object):void

関連項目




次の例では、入力フィールドを設定します。ユーザーはデータグリッド内の編集対象の行と列を入力フィールドに指定できます。この例を正しく機能させるには、パブリッシュする FLA ファイルのライブラリ内に、DataGrid、Button、Label、TextInput コンポーネントが必要です。
import fl.data.DataProvider;
import fl.controls.*;

var dp:DataProvider = new DataProvider();
var totalEntries:uint = 42;
var i:uint;
for(i=0; i<totalEntries; i++) {
    dp.addItem( {     col1:"CellName",
                    col2:"CellName",
                    col3:"CellName" } );            
}

var dg:DataGrid = new DataGrid();
dg.columns = [ "col1", "col2", "col3" ];
dg.editable = true;
dg.dataProvider = dp;
dg.move(200,10);
dg.setSize(200,300);
addChild(dg);

var rowIntro:Label = new Label();
rowIntro.text = "Row to edit:";
rowIntro.move(10,10);

var colIntro:Label = new Label();
colIntro.text = "Column to edit:";
colIntro.move(10,30);

var rowInputField:TextInput = new TextInput();
rowInputField.move(100,10);
rowInputField.setSize(30,20);

var colInputField:TextInput = new TextInput();
colInputField.move(100,30);
colInputField.setSize(30,20);

var editButton:Button = new Button();
editButton.move(10,60);
editButton.label = "Edit";
editButton.addEventListener(MouseEvent.CLICK,editGrid);

addChild(rowIntro);
addChild(colIntro);
addChild(rowInputField);
addChild(colInputField);
addChild(editButton);

function editGrid(e:MouseEvent):void {
    dg.editedItemPosition = { rowIndex:Number(rowInputField.text), columnIndex:Number(colInputField.text) };
}
editedItemRendererプロパティ 
editedItemRenderer:ICellRenderer  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

編集中のアイテムが位置する DataGrid コンポーネント内のアイテムレンダラーへの参照を取得します。編集中のアイテムがない場合、このプロパティは、null の値を含みます。

編集中のアイテムの現在の値を取得するには、editedItemRenderer.data プロパティを itemEditBegin イベントか itemEditEnd イベントのイベントリスナー内から使用します。

このプロパティは読み取り専用です。カスタムアイテムエディタを設定するには、関連する列を表すクラスの itemEditor プロパティを使用します。


実装
    public function get editedItemRenderer():ICellRenderer

関連項目




次の例では、入力フィールドを設定します。ユーザーはデータグリッド内の編集対象の行と列を入力フィールドに指定できます。この例を正しく機能させるには、パブリッシュする FLA ファイルのライブラリ内に、DataGrid、Button、Label、TextInput コンポーネントが必要です。
import fl.data.DataProvider;
import fl.controls.*;

var dp:DataProvider = new DataProvider();
var totalEntries:uint = 42;
var i:uint;
for(i=0; i<totalEntries; i++) {
    dp.addItem( {     col1:"CellName",
                    col2:"CellName",
                    col3:"CellName" } );            
}

var dg:DataGrid = new DataGrid();
dg.columns = [ "col1", "col2", "col3" ];
dg.editable = true;
dg.dataProvider = dp;
dg.move(200,10);
dg.setSize(200,300);
addChild(dg);

var rowIntro:Label = new Label();
rowIntro.text = "Row to edit:";
rowIntro.move(10,10);

var colIntro:Label = new Label();
colIntro.text = "Column to edit:";
colIntro.move(10,30);

var rowInputField:TextInput = new TextInput();
rowInputField.move(100,10);
rowInputField.setSize(30,20);

var colInputField:TextInput = new TextInput();
colInputField.move(100,30);
colInputField.setSize(30,20);

var editButton:Button = new Button();
editButton.move(10,60);
editButton.label = "Edit";
editButton.addEventListener(MouseEvent.CLICK,editGrid);

addChild(rowIntro);
addChild(colIntro);
addChild(rowInputField);
addChild(colInputField);
addChild(editButton);

function editGrid(e:MouseEvent):void {
    dg.editedItemPosition = { rowIndex:Number(rowInputField.text), columnIndex:Number(colInputField.text) };
}
headerHeightプロパティ 
headerHeight:Number  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

DataGrid ヘッダの高さ (ピクセル単位) を取得または設定します。

デフォルト値 : 25.


実装
    public function get headerHeight():Number
    public function set headerHeight(value:Number):void

関連項目




次の例では、スライダを使用して DataGrid コンポーネントインスタンスの headerHeight プロパティを変更します。

import fl.controls.DataGrid;
import fl.controls.Slider;
import fl.events.SliderEvent;

var headerHeightSlider:Slider = new Slider();
headerHeightSlider.minimum = 20;
headerHeightSlider.maximum = 40;
headerHeightSlider.snapInterval = 2;
headerHeightSlider.tickInterval = 4;
headerHeightSlider.liveDragging = true;
headerHeightSlider.move(10, 10);
headerHeightSlider.addEventListener(SliderEvent.CHANGE, changeHandler);
addChild(headerHeightSlider);

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.headerHeight = headerHeightSlider.value;
myDataGrid.addColumn("name");
myDataGrid.addColumn("value");
myDataGrid.addItem({name:"Person A", value:0.85});
myDataGrid.addItem({name:"Person B", value:0.87});
myDataGrid.width = 200;
myDataGrid.rowCount = myDataGrid.length;
myDataGrid.move(10, 30);
addChild(myDataGrid);

function changeHandler(event:SliderEvent):void {
    myDataGrid.headerHeight = event.value;
    myDataGrid.rowCount = myDataGrid.length;
}
horizontalScrollPolicyプロパティ 
horizontalScrollPolicy:String  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

水平スクロールバーが常にオンであるかどうかを示すブール値を取得または設定します。次のリストは、有効な値を示します。

メモ : DataGrid コンポーネント内の表示可能な列の結合された幅が DataGrid コンポーネントの利用できる幅よりも小さい場合、horizontalScrollPolicy プロパティの値によっては、列が DataGrid コンポーネントの利用できるスペースに表示されるようには拡張されない場合があります。次のリストは、これらの値とその効果を示します。

デフォルト値 : ScrollPolicy.OFF.


実装
    public function get horizontalScrollPolicy():String
    public function set horizontalScrollPolicy(value:String):void

関連項目




次の例では、セルの領域を広げるために水平スクロールバーを使用するデータグリッドを作成します。

import fl.controls.DataGrid;
import fl.controls.ScrollPolicy;
import fl.data.DataProvider;

var i:uint;
var totalRows:uint = 42;
var dp:DataProvider = new DataProvider();
for (i = 0; i < totalRows; i++) {
    dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber(), col5:getRandomNumber(), col6:getRandomNumber(), col7:getRandomNumber()});
}

var dg:DataGrid = new DataGrid();
dg.setSize(200,300);
dg.addColumn("col1");
dg.addColumn("col2");
dg.addColumn("col3");
dg.addColumn("col4");
dg.addColumn("col5");
dg.addColumn("col6");
dg.addColumn("col7");
dg.dataProvider = dp;
dg.horizontalScrollPolicy = ScrollPolicy.ON;
addChild(dg);

function getRandomNumber():uint {
    return Math.round(Math.random() * 100);
}
imeModeプロパティ 
imeMode:String  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

入力メソッドエディタ (IME) のモードを取得または設定します。IME を使用すると、ユーザーは QWERTY キーボードを使用して、中国語、日本語、および韓国語の文字セットから文字を入力することができます。

コンポーネントがフォーカスを取得したときに Flash は IME を指定されたモードに設定し、コンポーネントがフォーカスを失った後は元の値に復元します。

flash.system.IMEConversionMode クラスで、このプロパティの有効な値の定数を定義します。このプロパティを null に設定すると、IME がコンポーネントで使用されません。


実装
    public function get imeMode():String
    public function set imeMode(value:String):void

関連項目

itemEditorInstanceプロパティ 
public var itemEditorInstance:Object

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

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

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

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

関連項目




次の例では、データグリッドの itemEditorInstance プロパティにアクセスして、編集後のセルのテキストを判断します。
import fl.data.DataProvider;
import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridCellEditor;
import fl.controls.listClasses.ListData;
import fl.events.DataGridEvent;

var dp:DataProvider = new DataProvider();
var totalEntries:uint = 42;
var i:uint;
for(i=0; i<totalEntries; i++) {
    dp.addItem( {     col1:"CellName",
                    col2:"CellName",
                    col3:"CellName" } );            
}

var dg:DataGrid = new DataGrid();
dg.addEventListener(DataGridEvent.ITEM_EDIT_END,onItemEditEnd);
dg.dataProvider = dp;
dg.editable = true;
dg.setSize(300,200);
addChild(dg);

function onItemEditEnd(e:DataGridEvent):void {
    var cellEditor:DataGridCellEditor = dg.itemEditorInstance as DataGridCellEditor;
    var listData:ListData = cellEditor.listData;
    trace("After Edit: " + cellEditor.text);
}
labelFunctionプロパティ 
labelFunction:Function  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ラベルテキストとして使用する各アイテムのフィールドを特定する関数を取得または設定します。

デフォルト値 : null.


実装
    public function get labelFunction():Function
    public function set labelFunction(value:Function):void



次の例では、データグリッドの各列で label 関数を使用します。

import fl.controls.DataGrid;
import fl.controls.ScrollPolicy;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;

var i:uint;
var totalRows:uint = 16;
var dp:DataProvider = new DataProvider();
for (i = 0; i < totalRows; i++) {
    dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber()});
}

var c1:DataGridColumn = new DataGridColumn("col1");
c1.sortOptions = Array.NUMERIC;
var c2:DataGridColumn = new DataGridColumn("col2");
c2.sortOptions = Array.NUMERIC;
var c3:DataGridColumn = new DataGridColumn("col3");
c3.sortOptions = Array.NUMERIC;

var dg:DataGrid = new DataGrid();
dg.addColumn(c1);
dg.addColumn(c2);
dg.addColumn(c3);
dg.dataProvider = dp;
dg.labelFunction = currencyFormatter;
dg.move(10, 10);
dg.setSize(200, 300);
addChild(dg);

function getRandomNumber():Number {
    return Math.random() * 100;
}

function currencyFormatter(data:Object, column:DataGridColumn):String {
    return "$" + data[column.dataField].toFixed(2);
}
minColumnWidthプロパティ 
minColumnWidth:Number  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

DataGrid 列の最小幅 (ピクセル単位) を取得または設定します。この値が NaN に設定されている場合、列の最小幅を DataGrid コンポーネントの各列に個別に設定できます。

デフォルト値 : NaN.


実装
    public function get minColumnWidth():Number
    public function set minColumnWidth(value:Number):void



次の例では、データグリッドの水平スクロールを有効にし、サンプルストリングの長さに合わせて列の最小幅を 185 に設定します。
import fl.controls.DataGrid;
import fl.controls.ScrollPolicy;
import fl.data.DataProvider;

var i:uint;
var totalRows:uint = 42;
var dp:DataProvider = new DataProvider();
for (i = 0; i < totalRows; i++) {
    dp.addItem({col1:getString(), col2:getString(), col3:getString(), col4:getString(), col5:getString(), col6:getString(), col7:getString()});
}

var dg:DataGrid = new DataGrid();
dg.setSize(450,300);
dg.addColumn("col1");
dg.addColumn("col2");
dg.addColumn("col3");
dg.addColumn("col4");
dg.addColumn("col5");
dg.addColumn("col6");
dg.addColumn("col7");
dg.dataProvider = dp;
dg.horizontalScrollPolicy = ScrollPolicy.ON;
dg.minColumnWidth = 185;
addChild(dg);

function getString():String {
    return "This string requires a wide column";
}
resizableColumnsプロパティ 
public var resizableColumns:Boolean = true

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ユーザーが列のサイズを変更できるかどうかを示します。true の値は、ユーザーが列のサイズを変更できることを示します。false の値は、列のサイズが固定であることを示します。

この値が true の場合、ユーザーはヘッダセル間のグリッド線をドラッグすることで DataGrid コンポーネントの列を拡大または縮小できます。また、この値が true の場合、ユーザーは列のサイズを変更できます。ただし、個々の列の resizeable プロパティが false に設定されていない場合に限ります。

デフォルト値 : true.

関連項目




次の例では、DataGrid コンポーネントインスタンスを作成し、resizableColumns および sortableColumns プロパティを false に設定します。

import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;

var nameCol:DataGridColumn = new DataGridColumn("name");
nameCol.headerText = "NAME:";
nameCol.width = 120;

var valueCol:DataGridColumn = new DataGridColumn("value");
valueCol.headerText = "VALUE:";
valueCol.width = 80;

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn(nameCol);
myDataGrid.addColumn(valueCol);
myDataGrid.addItem({name:"Name A", value:"Value A"});
myDataGrid.addItem({name:"Name B", value:"Value B"});
myDataGrid.addItem({name:"Name C", value:"Value C"});
myDataGrid.resizableColumns = false;
myDataGrid.sortableColumns = false;
myDataGrid.width = 200;
myDataGrid.rowCount = myDataGrid.length;
myDataGrid.move(10, 10);
addChild(myDataGrid);
rowCountプロパティ 
rowCount:uint  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

リスト内に少なくとも部分的に表示される行数を取得または設定します。


実装
    public function get rowCount():uint
    public function set rowCount(value:uint):void

関連項目




次の例では、DataGrid コンポーネントインスタンスを作成し、rowCount プロパティを使用してデータグリッドのサイズを変更します。

import fl.controls.DataGrid;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem({col1:"item 1.A", col2:"item 1.B", col3:"item 1.C"});
dp.addItem({col1:"item 2.A", col2:"item 2.B", col3:"item 2.C"});
dp.addItem({col1:"item 3.A", col2:"item 3.B", col3:"item 3.C"});
dp.addItem({col1:"item 4.A", col2:"item 4.B", col3:"item 4.C"});

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn("col1");
myDataGrid.addColumn("col2");
myDataGrid.addColumn("col3");
myDataGrid.dataProvider = dp;
myDataGrid.move(10, 10);
myDataGrid.setSize(300, 200);
addChild(myDataGrid);

var fixedHeight:uint = Math.min(myDataGrid.rowCount, myDataGrid.length);
myDataGrid.rowCount = fixedHeight;

trace(myDataGrid.width, myDataGrid.height); // 300 105
rowHeightプロパティ 
rowHeight:Number  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

DataGrid コンポーネント内の各行の高さを取得または設定します (ピクセル単位)。

デフォルト値 : 20.


実装
    public function get rowHeight():Number
    public function set rowHeight(value:Number):void

関連項目




次の例では、データグリッド内の行の高さを調整し、ステージ上のすべてのコンポーネントのテキストサイズを小さくします。
import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;
import fl.managers.StyleManager;

var dp:DataProvider = new DataProvider();
var totalEntries:uint = 42;
var i:uint;
for(i = 0; i < totalEntries; i++) {
    dp.addItem( { col1:Math.random(), col2:Math.random(), col3:Math.random() } );           
}

var smallText:TextFormat = new TextFormat();
smallText.size = 9;
smallText.font = "Verdana";

var dg:DataGrid = new DataGrid();
dg.columns = ["col1", "col2", "col3"];
dg.rowHeight = 14;
dg.move(10, 10);
dg.setSize(400, 300);
dg.dataProvider = dp;
dg.setStyle("textFormat", smallText);
addChild(dg);

StyleManager.setStyle("textFormat", smallText);
showHeadersプロパティ 
showHeaders:Boolean  [read-write]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

DataGrid コンポーネントに列ヘッダが表示されるかどうかを示すブール値を取得または設定します。true の値は、DataGrid コンポーネントが列ヘッダを表示することを示します。false の値は、DataGrid コンポーネントが列ヘッダを表示しないことを示します。

デフォルト値 : true.


実装
    public function get showHeaders():Boolean
    public function set showHeaders(value:Boolean):void



次の例では、列ヘッダを持つデータグリッドと、列ヘッダなしのデータグリッドを 1 つずつ作成します。
import fl.controls.DataGrid;
import fl.controls.ScrollPolicy;
import fl.data.DataProvider;

var i:uint;
var totalRows:uint = 42;
var dp:DataProvider = new DataProvider();
for (i = 0; i < totalRows; i++) {
    dp.addItem({col1:Math.random(), col2:Math.random()});
}

var dg1:DataGrid = new DataGrid();
dg1.move(10,10);
dg1.setSize(200,300);
dg1.dataProvider = dp;
addChild(dg1);

var dg2:DataGrid = new DataGrid();
dg2.move(250,10);
dg2.setSize(200,300);
dg2.dataProvider = dp;
dg2.showHeaders = false;
addChild(dg2);
sortableColumnsプロパティ 
public var sortableColumns:Boolean = true

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ユーザーが列ヘッダセルをクリックして、データプロバイダ内のアイテムを並べ替えることができるかどうかを示します。この値が true の場合、ユーザーは列ヘッダセルをクリックして、データプロバイダのアイテムを並べ替えることができます。この値が false の場合、ユーザーは並べ替えることができません。

この値が true の場合、ヘッダセルへのユーザーのマウスクリックに対する個々の列の応答を防止するために、その列の sortable プロパティを false に設定します。

列のソートフィールドは、dataField か、DataGridColumn コンポーネントの sortCompareFunction プロパティのいずれかです。ユーザーが列を複数回クリックすると、並べ替え操作はそのたびに昇順と降順が交互に入れ替わります。

このプロパティと列の sortable プロパティの両方が true に設定されている場合、ユーザーが列ヘッダセルのマウスボタンを離した後に、DataGrid コンポーネントは、headerRelease イベントを送出します。preventDefault() メソッドの呼び出しが headerRelease イベントのハンドラメソッドから行われない場合、DataGrid コンポーネントは、dataField プロパティまたは sortCompareFunction プロパティの値に基づいて並べ替えを実行します。

デフォルト値 : true.

関連項目




次の例では、DataGrid コンポーネントインスタンスを作成し、sortableColumns プロパティを false に設定してユーザーがリストを並べ替えることができないようにします。

import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;
import fl.events.DataGridEvent;

var data:XML = <dataProvider>
        <data col1="Person A" col2="11.383" />
        <data col1="Person B" col2="3.399" />
        <data col1="Person C" col2="25.624" />
    </dataProvider>

var dp:DataProvider = new DataProvider(data);

var c1:DataGridColumn = new DataGridColumn("col1");
var c2:DataGridColumn = new DataGridColumn("col2");

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn(c1);
myDataGrid.addColumn(c2);
myDataGrid.dataProvider = dp;
myDataGrid.move(10, 10);
myDataGrid.setSize(160, 120);
myDataGrid.sortableColumns = false;
addChild(myDataGrid);
sortDescendingプロパティ 
sortDescending:Boolean  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ユーザーが列のヘッダをクリックしたときに、列が並べ替えられる順序を取得します。true の値は、列が降順に並べ替えられることを示します。false の値は、列が昇順に並べ替えられることを示します。

sortDescending プロパティは、ソートメソッドによる並べ替え操作の完了方法には影響しません。デフォルトで、並べ替え操作はストリングの大小文字を区別する並べ替えになります。この動作を変更するには、DataGridColumn クラスの sortOptions プロパティと sortCompareFunction プロパティを変更します。

メモ : headerRelease イベントに対するイベントリスナーからこのプロパティを調べると、前のソート操作のソート順がプロパティ値によって表されます。これは、次のソートがまだ発生していないためです。

デフォルト値 : false.


実装
    public function get sortDescending():Boolean

関連項目




次の例では、DataGrid コンポーネントインスタンスを作成し、headerRelease をリッスンし、sortDescending, sortIndex プロパティと dataField プロパティをトレースします。

import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;
import fl.events.DataGridEvent;

var dataXML:XML = <dataProvider>
        <data col1="Person A" col2="11.383" />
        <data col1="Person B" col2="3.399" />
        <data col1="Person C" col2="25.624" />
    </dataProvider>

var dp:DataProvider = new DataProvider(dataXML);

var c1:DataGridColumn = new DataGridColumn("col1");
var c2:DataGridColumn = new DataGridColumn("col2");
c2.sortOptions = Array.NUMERIC;

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn(c1);
myDataGrid.addColumn(c2);
myDataGrid.dataProvider = dp;
myDataGrid.width = 160;
myDataGrid.rowCount = myDataGrid.length;
myDataGrid.move(10, 10);
myDataGrid.addEventListener(DataGridEvent.HEADER_RELEASE, headerReleaseHandler);
addChild(myDataGrid);

function headerReleaseHandler(event:DataGridEvent):void {
    var myDG:DataGrid = event.currentTarget as DataGrid;
    var whichColumn:DataGridColumn = myDG.getColumnAt(event.columnIndex);
    trace("sortDescending:", myDG.sortDescending);
    trace("sortIndex:", myDG.sortIndex);
    trace("dataField:", whichColumn.dataField);
    trace("");
}
sortIndexプロパティ 
sortIndex:int  [read-only]

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

並べ替える列のインデックスを取得します。

デフォルト値 : -1.


実装
    public function get sortIndex():int

関連項目

コンストラクタの詳細
DataGrid()コンストラクタ
public function DataGrid()

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

DataGrid コンポーネントの新しいインスタンスを作成します。

メソッドの詳細
addColumn()メソッド
public function addColumn(column:*):DataGridColumn

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

columns 配列の末尾に列を追加します。

パラメータ

column:* — ストリングまたは DataGridColumn オブジェクトです。

戻り値
DataGridColumn — 追加された DataGridColumn オブジェクトです。

関連項目




次の例では、DataGrid コンポーネントインスタンスを作成し、addColumn() メソッドにストリングを渡して列を 2 つ追加します。

import fl.controls.DataGrid;

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn("name");
myDataGrid.addColumn("value");
myDataGrid.addItem({name:"Name 1", value:"Value 1"});
myDataGrid.addItem({name:"Name 2", value:"Value 2"});
myDataGrid.addItem({name:"Name 3", value:"Value 3"});
myDataGrid.width = 200;
myDataGrid.rowCount = myDataGrid.length;
myDataGrid.move(10, 10);
addChild(myDataGrid);

次の例では、DataGrid コンポーネントインスタンスを作成し、addColumn() メソッドに DataGridColumn オブジェクトを渡して列を 2 つ追加します。

import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;

var nameCol:DataGridColumn = new DataGridColumn("name");
var valueCol:DataGridColumn = new DataGridColumn("value");

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn(nameCol);
myDataGrid.addColumn(valueCol);
myDataGrid.addItem({name:"Name 1", value:"Value 1"});
myDataGrid.addItem({name:"Name 2", value:"Value 2"});
myDataGrid.addItem({name:"Name 3", value:"Value 3"});
myDataGrid.width = 200;
myDataGrid.rowCount = myDataGrid.length;
myDataGrid.move(10, 10);
addChild(myDataGrid);

次の例では、データプロバイダを設定する前に、列の順序とサイズを手動で追加することにより指定します。
import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { stateName:"California", stateAbbreviation:"CA" } );
dp.addItem( { stateName:"New York", stateAbbreviation:"NY" } );

var dg:DataGrid = new DataGrid();
var abbreviationColumn:DataGridColumn = dg.addColumn(new DataGridColumn("stateAbbreviation"));                                            
var nameColumn:DataGridColumn = dg.addColumn("stateName");
abbreviationColumn.width = 100;
nameColumn.width = 200;

dg.move(10,10);
dg.width = 300;
dg.rowCount = 2;
dg.dataProvider = dp;
addChild(dg);
addColumnAt()メソッド 
public function addColumnAt(column:*, index:uint):DataGridColumn

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

columns 配列の指定されたインデックス位置に列を挿入します。

パラメータ

column:* — 挿入される列を表すストリングまたは DataGridColumn オブジェクトです。
 
index:uint — 列が挿入される位置を識別する配列インデックスです。

戻り値
DataGridColumn — columns 配列に挿入された DataGridColumn オブジェクトです。

関連項目




次の例では、データプロバイダを設定する前に、列の順序とサイズを手動で追加することにより指定します。
import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { stateName:"California", stateAbbreviation:"CA" } );
dp.addItem( { stateName:"New York", stateAbbreviation:"NY" } );

var dg:DataGrid = new DataGrid();
var abbreviationColumn:DataGridColumn = dg.addColumn(new DataGridColumn("stateAbbreviation"));                                            
var nameColumn:DataGridColumn = dg.addColumn("stateName");
abbreviationColumn.width = 100;
nameColumn.width = 200;

dg.move(10,10);
dg.width = 300;
dg.rowCount = 2;
dg.dataProvider = dp;
addChild(dg);
createItemEditor()メソッド 
public function createItemEditor(colIndex:uint, rowIndex:uint):void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

itemEditor プロパティによって指定されたエディタを使用して、editedItemPosition プロパティによって識別される列と行のインデックスにアイテムレンダラーのアイテムエディタを作成します。

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

itemEditBegin イベントのイベントリスナーからこのメソッドを呼び出すことができます。他のコードからエディタを作成するには、editedItemPosition プロパティを設定します。その場合、itemEditBegin イベントを生成するように設定します。

パラメータ

colIndex:uint — データプロバイダ内で編集されるアイテムの列インデックスです。
 
rowIndex:uint — データプロバイダ内で編集されるアイテムの行インデックスです。

destroyItemEditor()メソッド 
public function destroyItemEditor():void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

アイテムレンダラーに対して現在開かれているアイテムエディタを閉じます。このメソッドは一般に、itemEditEnd イベントのイベントリスナーから呼び出されます。ただし、その前に、preventDefault() メソッドを呼び出して、デフォルトのイベントリスナーの実行を防止する必要があります。

editField()メソッド 
public function editField(index:uint, dataField:String, data:Object):void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

DataGrid コンポーネント内の指定されたフィールドまたはプロパティを編集します。

パラメータ

index:uint — 編集されるデータプロバイダアイテムのインデックスです。
 
dataField:String — 編集されるデータプロバイダアイテム内のフィールドまたはプロパティの名前です。
 
data:Object — 新しいデータ値です。


例外
RangeError — 指定されたインデックスは、0 より小さいか、またはデータプロバイダの長さ以上です。
getCellRendererAt()メソッド 
public function getCellRendererAt(row:uint, column:uint):ICellRenderer

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

DataGrid 内の指定された位置にあるセルレンダラーのインスタンスを取得します。

メモ : スクロールなどにより、指定された位置が表示されていない場合、このメソッドは null を返します。

パラメータ

row:uint — 行のインデックス。
 
column:uint — 列のインデックス。

戻り値
ICellRenderer — 指定された位置にある ICellRenderer オブジェクト。指定された位置にセルレンダラーが存在しない場合は null
getColumnAt()メソッド 
public function getColumnAt(index:uint):DataGridColumn

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

columns 配列の指定されたインデックスの位置にある列を取得します。

パラメータ

index:uint — 取得される列のインデックス、または列が見つからない場合は null になります。

戻り値
DataGridColumn — 指定されたインデックスで見つけられた DataGridColumn オブジェクトです。

関連項目

getColumnCount()メソッド 
public function getColumnCount():uint

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

DataGrid コンポーネント内にある列の数を取得します。

戻り値
uint — DataGrid コンポーネントに含まれる列の数。

関連項目




次の例では、新しい DataGrid に列を挿入し、columns 配列と getColumnCount() メソッドを使用して列の数を返します。

import fl.controls.DataGrid;
import fl.controls.ScrollPolicy;
import fl.data.DataProvider;

var i:uint;
var totalRows:uint = 16;
var dp:DataProvider = new DataProvider();
for (i = 0; i < totalRows; i++) {
    dp.addItem({col1:getRandomNumber(), col2:getRandomNumber(), col3:getRandomNumber(), col4:getRandomNumber()});
}

var dg:DataGrid = new DataGrid();
dg.setSize(200, 300);
dg.columns = ["col1", "col2", "col3"];
dg.dataProvider = dp;
addChild(dg);

trace("columns.length:", dg.columns.length); // 3
trace("getColumnCount():", dg.getColumnCount()); // 3

function getRandomNumber():uint {
    return Math.round(Math.random() * 100);
}

次の例では、DataGrid を作成し、columnStretch イベントが送出されるたびにデータグリッドの各列の幅をトレースします。

import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.events.DataGridEvent;

var nameCol:DataGridColumn = new DataGridColumn("name");
var valueCol:DataGridColumn = new DataGridColumn("value");

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn(nameCol);
myDataGrid.addColumn(valueCol);
myDataGrid.addItem({name:"Name 1", value:"Value 1"});
myDataGrid.addItem({name:"Name 2", value:"Value 2"});
myDataGrid.addItem({name:"Name 3", value:"Value 3"});
myDataGrid.width = 200;
myDataGrid.rowCount = myDataGrid.length;
myDataGrid.move(10, 10);
myDataGrid.addEventListener(DataGridEvent.COLUMN_STRETCH, columnStretchHandler);
addChild(myDataGrid);

function columnStretchHandler(event:DataGridEvent):void {
    var col:DataGridColumn;
    for each (col in myDataGrid.columns) {
        trace(col.dataField + ":", col.width + "px")
    }
    trace("");
}
getColumnIndex()メソッド 
public function getColumnIndex(name:String):int

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

指定された名前の列のインデックスを取得します。一致しなかった場合は、-1 を取得します。

パラメータ

name:String — 検索される列のデータフィールドです。

戻り値
int — 指定された名前の列が見つかる位置のインデックスです。

関連項目

getStyleDefinition()メソッド 
public static function getStyleDefinition():Object

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

現在のコンポーネントのデフォルトスタイルマップを取得します。スタイルマップには、使用されているスタイルに基づき、コンポーネントの適切な型が保持されます。たとえば、disabledTextFormat スタイルには、null または TextFormat オブジェクトの値が保持されます。現在のコンポーネントに対し、これらのスタイルを使用して、setStyle() を呼び出すことができます。次のコードでは、指定したコンポーネントのデフォルトの disabledTextFormat スタイルがオーバーライドされます。

componentInstance.setStyle("disabledTextFormat", new TextFormat());

戻り値
Object — デフォルトスタイルのオブジェクトです。

関連項目




次の例では、複数のコンポーネントクラス用のスタイルブラウザを作成します。
import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}
itemToCellRenderer()メソッド 
public override function itemToCellRenderer(item:Object):ICellRenderer

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

DataGrid コンポーネントは、特定のアイテムに対して複数のセルを持つため、itemToCellRenderer メソッドは常に null を返します。

パラメータ

item:Object — データプロバイダのアイテムです。

戻り値
ICellRenderernull を返します。
removeAllColumns()メソッド 
public function removeAllColumns():void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

DataGrid コンポーネントからすべての列を削除します。

関連項目

removeColumnAt()メソッド 
public function removeColumnAt(index:uint):DataGridColumn

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

columns 配列の指定されたインデックスの位置にある列を削除します。

パラメータ

index:uint — 削除される列のインデックスです。

戻り値
DataGridColumn — 削除された DataGridColumn オブジェクトです。列が指定されたインデックスで見つからない場合、このメソッドは、null を返します。

関連項目

scrollToIndex()メソッド 
public override function scrollToIndex(newCaretIndex:int):void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

指定されたインデックス位置にあるアイテムまでリストをスクロールします。インデックスが範囲外の場合、スクロール位置は変更されません。

パラメータ

newCaretIndex:int — スクロールするインデックス位置です。

spaceColumnsEqually()メソッド 
public function spaceColumnsEqually():void

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

表示可能な列の幅を同じサイズにリセットします。

イベントの詳細
columnStretch イベント
イベントオブジェクトの型: fl.events.DataGridEvent
DataGridEvent.type property = fl.events.DataGridEvent.COLUMN_STRETCH

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ユーザーが列を横方向に拡張した後に送出されます。

DataGridEvent.COLUMN_STRETCH 定数は、type プロパティ (columnStretch イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
columnIndexDataGrid オブジェクトの columns 配列内のヘッダー列の 0 から始まるインデックスです。
currentTargetイベントリスナーで event オブジェクトをアクティブに処理しているオブジェクトです。
dataFieldアイテムの列に関連付けられているデータ内のフィールドまたはプロパティの名前です。
itemRenderer展開された列に対応するヘッダーレンダラーです。
reasonnull
rowIndexデータプロバイダのアイテムの 0 から始まるインデックスです。
targetイベントを送出したオブジェクトです。ターゲットは、必ずしもイベントを受け取るオブジェクトではありません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。



次の例では、DataGrid コンポーネントを作成し、columnStretch イベントをリッスンします。

import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;
import fl.events.DataGridEvent;

var dp:DataProvider = new DataProvider();
dp.addItem({col1:"item 1.A", col2:"item 1.B", col3:"item 1.C"});
dp.addItem({col1:"item 2.A", col2:"item 2.B", col3:"item 2.C"});
dp.addItem({col1:"item 3.A", col2:"item 3.B", col3:"item 3.C"});
dp.addItem({col1:"item 4.A", col2:"item 4.B", col3:"item 4.C"});

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn("col1");
myDataGrid.addColumn("col2");
myDataGrid.addColumn("col3");
myDataGrid.dataProvider = dp;
myDataGrid.setSize(300, 200);
myDataGrid.move(10, 10);
myDataGrid.addEventListener(DataGridEvent.COLUMN_STRETCH, columnStretchHandler);
addChild(myDataGrid);

function columnStretchHandler(event:DataGridEvent):void {
    var dg:DataGrid = event.target as DataGrid;
    var column:DataGridColumn;
    var columnArray:Array = dg.columns;
    var dgColWidth:String;
    trace("resized column:", event.dataField);
    trace("columnIndex:", event.columnIndex);
    for each (column in columnArray) {
        dgColWidth = Number(column.width / dg.width * 100).toFixed(1);
        trace(column.dataField + ".width:", column.width + " pixels (" + dgColWidth + "%)");
    }
    trace("----------");
}
headerRelease イベント  
イベントオブジェクトの型: fl.events.DataGridEvent
DataGridEvent.type property = fl.events.DataGridEvent.HEADER_RELEASE

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ユーザーがヘッダセルをクリックした後に送出されます。

DataGridEvent.HEADER_RELEASE 定数は、type プロパティ (headerRelease イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
columnIndexDataGrid オブジェクトの columns 配列内のヘッダー列の 0 から始まるインデックスです。
currentTargetイベントリスナーで event オブジェクトをアクティブに処理しているオブジェクトです。
dataFieldアイテムの列に関連付けられているデータ内のフィールドまたはプロパティの名前です。
itemRendererクリックされたヘッダーレンダラーです。
reasonnull
rowIndex-1
targetイベントを送出したオブジェクトです。ターゲットは、必ずしもイベントを受け取るオブジェクトではありません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。



次の例では、DataGrid コンポーネントインスタンスを作成し、headerRelease イベントをリッスンします。

import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;
import fl.events.DataGridEvent;

var dp:DataProvider = new DataProvider();
dp.addItem({col1:"item 1.A", col2:"item 1.B", col3:"item 1.C"});
dp.addItem({col1:"item 2.A", col2:"item 2.B", col3:"item 2.C"});
dp.addItem({col1:"item 3.A", col2:"item 3.B", col3:"item 3.C"});
dp.addItem({col1:"item 4.A", col2:"item 4.B", col3:"item 4.C"});

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn("col1");
myDataGrid.addColumn("col2");
myDataGrid.addColumn("col3");
myDataGrid.dataProvider = dp;
myDataGrid.setSize(300, 200);
myDataGrid.move(10, 10);
myDataGrid.addEventListener(DataGridEvent.HEADER_RELEASE, headerReleaseHandler);
addChild(myDataGrid);

function headerReleaseHandler(event:DataGridEvent):void {
    var dg:DataGrid = event.target as DataGrid;
    trace("dataField:", event.dataField, "(columnIndex:" + event.columnIndex + ")");
    trace("sortIndex:", dg.sortIndex);
    trace("sortDescending:", dg.sortDescending);
    trace("----------");
}
itemEditBegin イベント  
イベントオブジェクトの型: fl.events.DataGridEvent
DataGridEvent.type property = fl.events.DataGridEvent.ITEM_EDIT_BEGIN

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

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

DataGridEvent.ITEM_EDIT_BEGIN 定数は、type プロパティ (itemEditBegin イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
columnIndexDataGrid オブジェクトの columns 配列内のヘッダー列の 0 から始まるインデックスです。
currentTargetイベントリスナーで event オブジェクトをアクティブに処理しているオブジェクトです。
dataFieldnull
itemRenderer編集対象のアイテムに対応するアイテムレンダラーです。
reasonnull
rowIndexデータプロバイダのアイテムの 0 から始まるインデックスです。
targetイベントを送出したオブジェクトです。ターゲットは、必ずしもイベントを受け取るオブジェクトではありません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。

関連項目

itemEditBeginning イベント  
イベントオブジェクトの型: fl.events.DataGridEvent
DataGridEvent.type property = fl.events.DataGridEvent.ITEM_EDIT_BEGINNING

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

ユーザーがアイテム上でマウスボタンを離したときなど、アイテムを編集する準備を行った後に送出されます。

DataGridEvent.ITEM__EDIT_BEGINNING 定数は、type プロパティ (itemEditBeginning イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
columnIndexDataGrid オブジェクトの columns 配列内のヘッダー列の 0 から始まるインデックスです。
currentTargetイベントリスナーで event オブジェクトをアクティブに処理しているオブジェクトです。
dataFieldアイテムの列に関連付けられているデータ内のフィールドまたはプロパティの名前です。
itemRenderer編集対象のアイテムに対応するアイテムレンダラーです。
reasonnull
rowIndexデータプロバイダのアイテムの 0 から始まるインデックスです。
targetイベントを送出したオブジェクトです。ターゲットは、必ずしもイベントを受け取るオブジェクトではありません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。

関連項目

itemEditEnd イベント  
イベントオブジェクトの型: fl.events.DataGridEvent
DataGridEvent.type property = fl.events.DataGridEvent.ITEM_EDIT_END

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

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

DataGridEvent.ITEM_EDIT_END 定数は、type プロパティ (itemEditEnd イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
columnIndexDataGrid オブジェクトの columns 配列内のヘッダー列の 0 から始まるインデックスです。
currentTargetイベントリスナーで event オブジェクトをアクティブに処理しているオブジェクトです。
dataFieldアイテムの列に関連付けられているデータ内のフィールドまたはプロパティの名前です。
itemRenderer編集対象のアイテムに対応するアイテムレンダラーです。
reasonイベントの理由を定義する定数です。値は DataGridEventReason クラスのメンバーである必要があります。
rowIndexデータプロバイダのアイテムの 0 から始まるインデックスです。
targetイベントを送出したオブジェクトです。ターゲットは、必ずしもイベントを受け取るオブジェクトではありません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。

関連項目

itemFocusIn イベント  
イベントオブジェクトの型: fl.events.DataGridEvent
DataGridEvent.type property = fl.events.DataGridEvent.ITEM_FOCUS_IN

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

アイテムがフォーカスを受け付けた後に送出されます。

DataGridEvent.ITEM_FOCUS_IN 定数は、type プロパティ (itemFocusIn イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
columnIndexDataGrid オブジェクトの columns 配列内のヘッダー列の 0 から始まるインデックスです。
currentTargetイベントリスナーで event オブジェクトをアクティブに処理しているオブジェクトです。
dataFieldnull
itemRenderer編集対象のアイテムに対応するアイテムレンダラーです。
reasonnull
rowIndexデータプロバイダのアイテムの 0 から始まるインデックスです。
targetイベントを送出したオブジェクトです。ターゲットは、必ずしもイベントを受け取るオブジェクトではありません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。

関連項目

itemFocusOut イベント  
イベントオブジェクトの型: fl.events.DataGridEvent
DataGridEvent.type property = fl.events.DataGridEvent.ITEM_FOCUS_OUT

言語バージョン : ActionScript 3.0
Player のバージョン : Flash Player 9.0.28.0

アイテムがフォーカスを失った後に送出されます。

DataGridEvent.ITEM_FOCUS_OUT 定数は、type プロパティ (itemFocusOut イベントオブジェクト) の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
columnIndexDataGrid オブジェクトの columns 配列内のヘッダー列の 0 から始まるインデックスです。
currentTargetイベントリスナーで event オブジェクトをアクティブに処理しているオブジェクトです。
dataFieldnull
itemRenderer編集対象のアイテムに対応するアイテムレンダラーです。
reasonnull
rowIndexデータプロバイダのアイテムの 0 から始まるインデックスです。
targetイベントを送出したオブジェクトです。ターゲットは、必ずしもイベントを受け取るオブジェクトではありません。イベントを受け取るオブジェクトにアクセスするには、currentTarget プロパティを使用します。

関連項目

例の使用法
DataGridExample.as

この例は、DataGrid インスタンスを動的に作成して、そのイベントを監視する方法を示します。

例を実行するには、次の手順に従います。

  1. ライブラリに DataGrid コンポーネントを追加します。
  2. このコードを DataGridExample.as として FLA ファイルと同じディレクトリに保存します。
  3. FLA ファイルのドキュメントクラスを DataGridExample に設定します。
package 
{
    import fl.controls.DataGrid;
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    
    public class DataGridExample extends Sprite
    {
        var sampleItem1:Object = { Name:"John Alpha",     Number:"555-123-0101", Email:"jalpha@fictitious.com" };
        var sampleItem2:Object = { Name:"Mary Bravo",     Number:"555-372-3322", Email:"mbravo@fictitious.com" };
        var sampleItem3:Object = { Name:"Trevor Gamma", Number:"555-485-1212", Email:"tgamma@fictitious.com" };
        var sampleItem4:Object = { Name:"Susan Delta",     Number:"555-987-3434", Email:"sdelta@fictitious.com" };        
        
        var dg:DataGrid;
        var tf1:TextField;
        var tf2:TextField;
        var tf3:TextField;
        
        public function DataGridExample() {
            createDataGrid();
            createTextFields();
        }
        private function createDataGrid():void {
            dg = new DataGrid();
            dg.move(10, 10);
            dg.width = 500
            dg.rowCount = 4;
            dg.columns = ["Name", "Number", "Email"];
            dg.addItem(sampleItem1);
            dg.addItem(sampleItem2);
            dg.addItem(sampleItem3);
            dg.addItem(sampleItem4);
            
            dg.addEventListener(Event.CHANGE, gridItemSelected);
            dg.minColumnWidth = dg.width / 3;
            addChild(dg);
        }
        private function createTextFields():void {
            tf1 = new TextField();
            tf2 = new TextField();
            tf3 = new TextField();
            tf1.x = 10;
            tf2.x = 10;
            tf3.x = 10;
            tf1.autoSize = TextFieldAutoSize.LEFT;
            tf2.autoSize = TextFieldAutoSize.LEFT;
            tf3.autoSize = TextFieldAutoSize.LEFT;
            tf1.y = 150;
            tf2.y = 175;
            tf3.y = 200;
            
            addChild(tf1);
            addChild(tf2);
            addChild(tf3);            
        }
        private function gridItemSelected(e:Event):void {
            tf1.text = "Name: " + e.target.selectedItem.Name;
            tf2.text = "Number: " + e.target.selectedItem.Number;
            tf3.text = "Email: " + e.target.selectedItem.Email;            
        }
    }
}




 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flash/9.0_jp/ActionScriptLangRefV3/fl/controls/DataGrid.html