VP Find

4D v19

VP Find


VP Find ( rangeObj ; searchValue {; searchCondition {; replaceValue}} ) -> 戻り値

引数	型	説明
rangeObj	オブジェクト	レンジオブジェクト
searchValue	テキスト	検索値
searchCondition	オブジェクト	検索条件を格納したオブジェクト
replaceValue	テキスト	置き換え値
戻り値	オブジェクト	レンジオブジェクト

説明

VP Find コマンドはrangeObj 引数で指定したレンジ内でsearchValue 引数で指定した値を検索します。任意の引数を使用すると検索を検索の条件を詳細に指定したり、または見つかった結果を置き換えることを指定したりすることができます。

rangeObj 引数には、検索するレンジを格納しているオブジェクトを渡します。

searchValue 引数には、rangeObj 引数で指定したレンジ内で検索するテキスト値を渡します。

任意のsearchCondition 引数を渡すことで、検索がどのように実行されるかを指定することができます。以下のプロパティがサポートされています:

プロパティ 型詳細

afterColumn 倍長整数検索する開始カラムの直前のカラムの数値。rangeObj 引数が組み合わさったレンジである場合、渡されるカラムの数値は最初のレンジのものでなければなりません。デフォルト値: -1 (rangeObj の最初)

afterRow 倍長整数検索する開始業の直前の行の数値。rangeObj 引数が組み合わさったレンジである場合、渡される行の数値は最初のレンジのものでなければなりません。デフォルト値: -1 (rangeObj の最初)

all

ブール

True - rangeObj 引数内でsearchValue 引数の値に合致するセルは全て返されます。
False - (デフォルト値) rangeObj 引数内でsearchValue 引数の値に合致する最初のセルのみが返されます。

flags

倍長整数

定数	コメント
vk find flag exact match	セルの中身全体が検索値と完全に一致する必要があります
vk find flag ignore case	大文字と小文字は同じであると判断されます。例:"a"と"A"は同じとみなされます。
vk find flag none	検索ブラグは何も指定されていません(デフォルト)。
vk find flag use wild cards	検索文字列においてワイルドカード文字()を使用できます。ワイルドカードはどの文字列比較においても使用でき、何文字でもどの文字に合致することができます。 * - 0から複数文字に使用可能。例えば、"bl*" を検索した場合、"bl"、"black"、"blue"、"blob" などが合致します。 ? - 単一文字に使用可能。例えば、"h?t" を検索した場合、"hot"、"hat"、"hit" などが合致します。

フラグは組み合わせることができます。例:

$search.flags:=vk find flag use wild cards+vk find flag ignore case

order

倍長整数

定数	コメント
vk find order by columns	検索がカラムごとに実行されます。カラムの各行が検索されたあとに次のカラムへと移動します。
vk find order by rows	検索が行ことに実行されます。行の各カラムが検索されたあとに次の行へと移動します(デフォルト)

target

倍長整数

定数	コメント
vk find target formula	セルフォーミュラ内で検索が行われます。
vk find target tag	セルタグ内で検索が実行されます。
vk find target text	セルテキスト内で検索が実行されます。(デフォルト)

これらのフラグは組み合わせることができます。例:

$search.target:=vk find target formula+vk find target text

任意のreplaceValue 引数には、rangeObj 引数のレンジ内で見つかったsearchValue 引数の値のテキストを置き換えるテキストを渡すことができます。

返されるオブジェクト

この関数はそれぞれの検索値が見つかったか置き換えられたかを表すレンジオブジェクトを返します。何も見つからなかった場合には空のレンジオブジェクトが返されます。

例題 1

"Total" という単語が入っている最初のセルを見つけたい場合:

 var $range;$result : Object

 

 $range:=VP All("ViewProArea")

 

 $result:=VP Find($range;"Total")

例題 2

"Total" のセルを見つけ、それを"Grand Total" で置き換えたい場合:

 var $range;$condition;$result : Object

 

 $range:=VP All("ViewProArea")

 

 $condition:=New object

 $condition.target:=vk find target text

 $condition.all:=True // ドキュメント全体を検索

 $condition.flags:=vk find flag exact match

 

  // カレントシート内にて"Total" のみを格納しているセルをGrand Total" で置き換える

 $result:=VP Find($range;"Total";$condition;"Grand Total")

 

  // 戻り値のレンジオブジェクトを見て見つかったどうかをチェック

 If($result.ranges.length=0)

    ALERT("No result found")

 Else

    ALERT($result.ranges.length+" results found")

 End if