Adobe ColdFusion 8

ColdFusion.Grid.sort

説明

指定された HTML 形式のグリッドをソートします。

関数のシンタックス

ColdFusion.Grid.sort(name [, columnName, direction])

参照項目

<c code>cfgrid<c code>ColdFusion.Grid.getGridObject<c code>ColdFusion.Grid.refresh、『ColdFusion 開発ガイド』の"HTML 形式のグリッドの使用"

履歴

ColdFusion 8: この関数が追加されました。

パラメータ

パラメータ

説明

name

ソートする cfgrid タグの name 属性の値です。

columnName

ソート順を決定する列の名前です。

direction

ソートの方向です。次のいずれかの値を指定する必要があります。

  • ASC (デフォルト)
  • DESC

戻り値

この関数は値を返しません。

使用方法

この関数は、グリッドに表示されるデータをソートします。文字列データの場合は大文字と小文字が区別されずにソートされ、数値データの場合は数値としてソートされます。 指定された列の内容を基準にして、表示されるグリッドの順序が決定されます。リモートデータソースを使用するグリッドの場合は、バインド属性 cfgridsortcolumn および cfgridsortdirection を通じて、データを提供する CFC 関数に列名とソート方向が通知されます。この CFC 関数がこれらの値を使用して適切にソートを実行できることを確認する必要があります。