|
構造化タグのスナップショットを作成する。
構文
CreateSnapshotStructureTag(
count,
&recourdCnt
[,compareName]
[,compareClass]
[,compareMember]
[,compareFilter]
)
パラメータ
count
|
|
型：
|
Numeric
|
|
最大取得件数。-1の時制限無し。
|
&recourdCnt
|
|
型：
|
Numeric
|
|
作成したスナップショットのレコード数を受け取る。
|
compareName
|
|
型：
|
String
|
|
タグ名に対するフィルタ条件。
|
compareClass
|
|
型：
|
String
|
|
クラス名に対するフィルタ条件。
|
compareMember
|
|
型：
|
String
|
|
メンバ名に対するフィルタ条件。指定したメンバ名が存在するものだけを列挙する。
|
compareFilter
|
|
型：
|
String
|
|
メンバの値条件。例えば、Value>10 など。
|
戻り値
|
|
型：
|
Boolean
|
|
FALSE - 失敗。TRUE - 成功。
|
フィルタ条件で絞込んだ構造化タグのスナップショットを作成します。いったん作成したスナップショットはSortSnapshotStructureTagメソッドでソート（並び替え）ができます。
また、いったん作成したスナップショットは、GetSnapshotStructureTagValueにより高速に構造化タグの情報を取得できます。
CreateSnapshotStructureTag処理後はフィルタ条件で絞り込む処理をする必要がなくなるため、処理が軽減できます。
繰り返し値を取得したり、大量なタグの情報をページ切り替えして表示したりする場合などに適しています。
再度、CreateSnapshotStructureTagを呼び出すと前のスナップショットが削除され、新たなスナップショットが作成されます。
作成できるスナップショットは１つのブラウザに１つです。フィルタ条件についてはFilterStructureTagNameを参照して下さい。
|
スナップショットの生成
|
var vRecordCnt;
if (::CreateSnapshotStructureTag(-1, vRecordCnt) == F) {
・・・・
|
|
並び替えを行う
|
if (::SortSnapshotStructureTag(c("Value", "[Name]"), c(F, F)) == F) {
・・・・
|
|
情報の取得
|
var vTag, vValue;
var vMember = c("Value", "Hi", "Lo");
if (::GetSnapshotStructureTagValue(0, vRecordCnt, vMember, vTag, vValue) == F){
・・・・
|
|
グリッドコントロール（parent.Grid）に表示
|
parent.Grid.SetTableData(vValue);
parent.Grid.SetColData(-1, vTag);
parent.Grid.SetRowData(-1, vMember);
|
|
サポート対象
|
スクリプトVer2（SC2）アクションで構造化タグ関連のメソッドを使用する場合は、new演算子でStructureTagオブジェクトのインスタンスを生成してください。
例）
var obj = new StructureTag;
obj.GetStructureTagValue( ・・・ );
|
参照
GetStructureMemberProperty
FilterStructureTagName
FilterStructureTagValue
CreateSnapshotStructureTag
SortSnapshotStructureTag
GetSnapshotStructureTagValue
|
