列に関連付けられているデータプロバイダアイテム内のフィールドまたはプロパティの名前です。 各 AdvancedDataGridColumn コントロールでは、アイテムレンダラーで表示できるテキストを計算するために、このプロパティと labelFunction プロパティ、またはそのいずれかが設定されている必要があります。 dataField プロパティおよび labelFunction プロパティが設定されている場合、データは labelFunction を使用して表示され、dataField を使用してソートされます。dataField で指定された名前を持つプロパティが存在しない場合、ソートを正しく実行するには sortCompareFunction を設定する必要があります。

このプロパティのこの値は、必ずしも列ヘッダーに表示されるストリングであるとは限りません。 このプロパティは、データプロバイダのデータにアクセスする目的でのみ使用します。 詳細については、headerText プロパティを参照してください。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 dataFieldChanged イベントが送出されます。

関連項目

データヒントとして表示するデータプロバイダ内のフィールドの名前です。 デフォルトでは、各データプロバイダアイテムで label という名前のプロパティが検索され、その値が表示されます。 ただし、データプロバイダに label プロパティが存在しない場合は、dataTipField プロパティを設定して別のプロパティを指定できます。 例えば、データベースに含まれる人物のフルネームをユーザーに表示する場合には、値を "FullName" に設定できます。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 dataTipFieldChanged イベントが送出されます。

データヒントを決定するためにデータプロバイダの各アイテムで実行するコールバック関数を指定します。 このプロパティは itemToDataTip() メソッドで使用します。

デフォルトでは、各データプロバイダアイテムで label という名前のプロパティが検索され、その値が dataTip として表示されます。 ただし、データプロバイダによっては、label プロパティが存在せず、また行にデータを表示するために使用できる別のプロパティも存在しない場合があります。 例えば、フルネームを dataTip として表示したい場合に、データプロバイダに lastName フィールドと firstName フィールドが別々に存在しているケースが考えられます。 このような場合は、両方のフィールドの値を単一のストリングとして返す関数を dataTipFunction プロパティに指定します。 また、フォーマットとローカライズを処理するために dataTipFunction プロパティを使用することもできます。

この関数は、データプロバイダエレメントを含む単一の Object パラメータを取り、ストリングを返す関数であることが必要です。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 dataTipFunctionChanged イベントが送出されます。

列の中のアイテムが編集可能かどうかを示すフラグです。 このプロパティが true で、AdvancedDataGrid の editable プロパティも true であれば、列内のアイテムは編集可能です。アイテムをクリックするか、Tab キーと矢印キーを使用してアイテムに移動することにより、アイテムを個別に編集できます。

デフォルト値 : true.

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

デフォルト値 : "text".

アイテムレンダラーのサイズに対するアイテムエディタの高さです（ピクセル単位）。 このプロパティを使用すると、エディタをアイテムレンダラーと数ピクセル分オーバーラップさせて、エディタの周囲の境界線を補正することができます。 なお、エディタの表示中にこれらの値を変更しても、それらの変更は現在のエディタに反映されませんが、次のアイテムレンダラーでエディタが開かれたときに反映されます。

デフォルト値 : 0.

アイテムエディタで Enter キーを使用するかどうかを示すフラグです。 true の場合、アイテムエディタは Enter キーを使用します。この場合、AdvancedDataGrid は Enter キーを検索せず、Enter キーが押されるとエディタを移動します。 なお、エディタの表示中にこの値を変更しても、それらの変更は現在のエディタに反映されませんが、次のアイテムレンダラーでエディタが開かれたときに反映されます。

デフォルト値 : false.

アイテムレンダラーのサイズに対するアイテムエディタの幅です（ピクセル単位）。 このプロパティを使用すると、エディタをアイテムレンダラーと数ピクセル分オーバーラップさせて、エディタの周囲の境界線を補正することができます。 なお、エディタの表示中にこれらの値を変更しても、それらの変更は現在のエディタに反映されませんが、次のアイテムレンダラーでエディタが開かれたときに反映されます。

デフォルト値 : 0.

アイテムの左上隅の位置に対するアイテムエディタの左上隅の x 座標です（ピクセル単位）。 このプロパティを使用すると、エディタをアイテムレンダラーと数ピクセル分オーバーラップさせて、エディタの周囲の境界線を補正することができます。 なお、エディタの表示中にこれらの値を変更しても、それらの変更は現在のエディタに反映されませんが、次のアイテムレンダラーでエディタが開かれたときに反映されます。

デフォルト値 : 0.

アイテムの左上隅の位置に対するアイテムエディタの左上隅の y 座標です（ピクセル単位）。 このプロパティを使用すると、エディタをアイテムレンダラーと数ピクセル分オーバーラップさせて、エディタの周囲の境界線を補正することができます。 なお、エディタの表示中にこれらの値を変更しても、それらの変更は現在のエディタに反映されませんが、次のアイテムレンダラーでエディタが開かれたときに反映されます。

デフォルト値 : 0.

mx.formatters.Formatter のサブクラスのインスタンスです。 コントロールはこのクラスを使用して列テキストを書式設定します。

デフォルト値 : null.

列の列ヘッダーを表示するアイテムレンダラーインスタンスに対応するクラスファクトリです。 このプロパティの値として、ドロップインアイテムレンダラー、インラインアイテムレンダラー、またはカスタムアイテムレンダラーの各コンポーネントを指定できます。

デフォルトのアイテムレンダラーは AdvancedDataGridItemRenderer クラスです。これはアイテムデータをテキストとして表示します。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 headerRendererChanged イベントが送出されます。

この列のヘッダーのテキストです。 デフォルトでは、AdvancedDataGrid コントロールは dataField プロパティの値をヘッダーテキストとして使用します。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 headerTextChanged イベントが送出されます。

列ヘッダーのテキストが 1 行に収まらない場合にテキストを折り返す場合は true に設定します。 undefined の場合は、AdvancedDataGrid コントロールの wordWrap プロパティが使用されます。 このプロパティは、AdvancedDataGrid コントロールの headerWordWrap プロパティをオーバーライドします。

デフォルト値 : 未定義.

IME（入力メソッドエディタ）のモードを指定します。 IME モードを使用することによって、ユーザーは中国語、日本語、および韓国語のテキストを入力できます。 itemFocusIn イベントが発生すると IME モードが設定され、itemFocusOut イベントが発生すると設定前の値に戻ります。 このプロパティで有効な値の定数は、flash.system.IMEConversionMode クラスで定義されています。

デフォルト値は null です。この場合、AdvancedDataGrid コントロールの imeMode プロパティの値が使用されます。

関連項目

列が編集可能な場合に列の編集に使用するアイテムエディタのインスタンスに対応するクラスファクトリです。

デフォルト値は mx.controls.TextInput コントロールです。

関連項目

列にある各アイテムのデータを表示するアイテムレンダラーインスタンスに対応するクラスファクトリです。 このプロパティの値として、ドロップインアイテムレンダラー、インラインアイテムレンダラー、またはカスタムアイテムレンダラーの各コンポーネントを指定できます。

デフォルトのアイテムレンダラーは AdvancedDataGridItemRenderer クラスです。これはアイテムデータをテキストとして表示します。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 itemRendererChanged イベントが送出されます。

関連項目

この列に表示するテキストを決定する関数です。 デフォルトでは、データにあるフィールドのうち、その列の名前と一致するフィールドのテキストが列に表示されます。 しかし、データ内の複数のフィールドに基づくテキストや、適切に書式設定されていない情報を表示したい場合があります。 そのような場合は、labelFunction を使用してコールバック関数を指定します。

AdvancedDataGrid コントロールの場合、メソッドシグネチャの形式は次のようになります。

labelFunction(item:Object, column:AdvancedDataGridColumn):String

ここで、item は AdvancedDataGrid アイテムオブジェクトを示し、column は AdvancedDataGrid 列を示します。

コールバック関数を使用すると、データ内の firstName フィールドと lastName フィールドの結合、Date に対するカスタム書式の適用、数字で表された月からストリングへの変換などが可能です。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 labelFunctionChanged イベントが送出されます。

列の最小幅です（ピクセル単位）。

デフォルト値 : 20.

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 minWidthChanged イベントが送出されます。

アイテムレンダラーがアイテムエディタでもあることを示すフラグです。 このプロパティを true に設定すると itemEditor プロパティは無視され、そのアイテムのアイテムレンダラーがアイテムエディタとして使用されます。

デフォルト値 : false.

ユーザーが列の幅を変更できるようにする場合は true に設定します。 true の場合、ユーザーは列ヘッダーの間のグリッド線をドラッグして、列のサイズを変更できます。

デフォルト値 : true.

列にデータヒントを表示する場合は true に設定します。 true の場合、行のテキストに対してデータヒントが表示されます。 データヒントは、長すぎて行に収まらないテキストを表示するためのツールヒントです。

デフォルト値 : false.

ユーザーがこの列のヘッダーをクリックしてデータプロバイダをソートできることを示す場合は true に設定します。 このプロパティと AdvancedDataGrid の sortableColumns プロパティの両方を true に設定すると、ユーザーがこの列のヘッダーをマウスでクリックして離したときに、AdvancedDataGrid コントロールから headerRelease イベントが送出されます。 他のハンドラが preventDefault() メソッドを headerRelease イベントに対して呼び出さなければ、列の dataField プロパティまたは sortCompareFunction を使用してデータプロバイダのアイテムが並べ替えられます。

デフォルト値 : true.

列の中のデータをソートするときに呼び出されるコールバック関数です。 このプロパティを指定しない場合、基本的なストリングまたは数値のソートを使用してデータのソートが試行されます。 データがストリングでも数値でもない場合、または dataField プロパティがデータプロバイダの有効なプロパティでない場合は、ソートが機能しないか、例外が生成されます。 labelFunction プロパティの値を指定する場合は、この列でのソートが許可されていない場合を除き、sortCompareFunction プロパティにも関数を指定する必要があります。

AdvancedDataGrid コントロールはこの関数を使用して、データプロバイダのコレクションのエレメントをソートします。 コールバック関数の関数シグネチャは 2 つのパラメータを受け取り、次のような形式に従う必要があります。

mySortCompareFunction(obj1:Object, obj2:Object):int 

obj1 — 比較するデータエレメントです。

obj2 — obj1 の比較対象となるデータエレメントです。

この関数はオブジェクトの比較に基づいて次のような値を返す必要があります。

• 昇順で obj1 が obj2 よりも先に出現する場合は -1。
• obj1 と obj2 が同じ場合は 0。
• 昇順で obj1 が obj2 よりも後で出現する場合は 1。

メモ：obj1 パラメータと obj2 パラメータはデータプロバイダエレメント全体です。特定のアイテムのデータではありません。

デフォルト値 : null.

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 sortCompareFunctionChanged イベントが送出されます。

列ソートが昇順（false）か降順（true）かを示します。

デフォルト値 : false.

各セルをレンダリングするときに呼び出されるコールバック関数です。 この関数のシグネチャは次のとおりです。

function myStyleFunction(data:Object, column:AdvancedDataGridColumn):Object

data - レンダリングされるアイテムに関連付けられたデータオブジェクトです。

column - アイテムレンダラーが関連付けられている AdvancedDataGridColumn インスタンスです。

戻り値は、スタイルを含むオブジェクトにする必要があります。スタイルは必要な値を持つプロパティで表します。 次に例を示します。

{ color:0xFF0000, fontWeight:"bold" }

true の場合、列は可視です。 列を非表示にする場合は false に設定します。

デフォルト値 : true.

列の幅を示すピクセル数です。 AdvancedDataGrid の horizontalScrollPolicy プロパティが false の場合、表示されるすべての列が表示可能領域内に収まる必要があります。この場合、すべての列幅を合計した幅が表示可能領域に対して小さすぎたり大きすぎたりした場合、AdvancedDataGrid では個々の列の幅がそのまま使用されるとは限りません。

デフォルト値 : 100.

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 widthChanged イベントが送出されます。

この列の行に表示するテキストが 1 行に収まらない場合に折り返す場合は false に設定します。undefined の場合は、AdvancedDataGrid コントロールの wordWrap プロパティが使用されます。

デフォルト値 : 未定義.

コンストラクタです。

この列のクローンを作成し、この列と同じプロパティおよびスタイルを持つ新しい Column を返します。 使用可能なすべてのプロパティが設定されるわけではありません。

dataTipField プロパティおよび dataTipFunction プロパティに基づき、指定されたデータオブジェクトのデータヒントとしてアイテムレンダラーが表示するストリングを返します。 このメソッドがパラメータをストリングに変換できない場合は、単一の空白文字が返されます。

このメソッドは、AdvancedDataGridColumn クラスのサブクラスを作成するために開発者が使用するものです。 アプリケーション開発者による使用は考慮されていません。

パラメータ

指定されたデータオブジェクトに対してアイテムレンダラーが表示するストリングを返します。 AdvancedDataGridColumn またはその AdvancedDataGrid コントロールの labelFunction プロパティが null でない場合は、その関数がデータオブジェクトに適用されます。 それ以外の場合、このメソッドは、dataField プロパティによって指定されたフィールドの内容を抽出するか、データオブジェクトのストリング値を取得します。 このメソッドがパラメータをストリングに変換できない場合は、単一の空白文字が返されます。

パラメータ