アイテムの持つ情報をチェックする

説明

コンポーネントに追加できる項目は、ローカルファイルと仮想ファイルである。

ローカルファイルとは、ファイルダイアログを使って登録されたアイテムを指し、仮想ファイルとは、addVirtualFile関数とaddVirtualFileList関数を使って登録された仮想ファイルを表すアイテムを指す。

アイテムに関する情報を得るために、コンポーネントには多くの操作関数が用意されている。

var dx = dx5.get("component-id");

// すべての項目の数を返す。
var countAll = dx.getTotalItemCount();

// ローカルファイルのエントリ数を返す。
var countLocal = dx.getTotalLocalFileCount();

// 仮想ファイルのエントリ数を返す。
var countVirtual = dx.getTotalVirtualFileCount();

// 削除された仮想ファイルエントリの数を返します。
var countRemoved = dx.getTotalRemovedFileCount();

特定の項目の詳細情報を取得するには、まずそのオブジェクトを取得する必要があります。

getItems関数、getSelectedItems関数、getItemById関数、getItemByIndex関数を使用して、特定の項目や配列を取得することができます。

var dx = dx5.get("component-id");

// 与えられたIDまたはシーケンスに対応するアイテムを返す。
var item1 = dx.getItemById("アイテムID");
var item2 = dx.getItemByIndex(3);

// すべてのアイテムの配列を返す。
var allItems = dx.getItems();

// 選択された項目の配列を返す
var selectedItems = dx.getSelectedItems();

// チェックされた項目の配列を返す
var checkedItems = dx.getCheckedItems();

アイテムは、以下のプロパティを持つJSONオブジェクトである：

controlId: コンポーネントID
id: コンポーネントが決定するアイテムのユニークID。(マルチモジュールとIEモジュールではIDの作成方法が異なる場合があります)
type: タイプ：アイテムがローカルファイルか仮想ファイルかのデリミタ。
name: アイテム名(ファイル名)。
vindex: 仮想ファイルの場合、仮想ファイルを区別するキー。(通常はデータベースのキーが使われます）。
openUrl: 仮想ファイルの場合、ファイルを開くためのウェブパス。
downUrl: 仮想ファイルの場合、ファイルをダウンロードするためのウェブパスです。
size: ファイルのサイズ。
checked: チェック済み：ファイルの状態をチェックします。
lock: ロックファイルのロック状態。
status: ファイルのアップロードステータス。

返される項目はすべて複製オブジェクトであるため、ターゲット・オブジェクトの属性値を変更しても内部コンポーネントには影響しません。

説明

例