Application.ReplaceEx メソッド (Project)

指定したフィールド、または、すべての利用可能なフィールドのフィルター処理されていない値を検索し、指定した値に置き換えられます。

構文

ReplaceEx (フィールドテスト置換ReplaceAllNextMatchCaseFieldIDTestIDSearchAllFields)

Application オブジェクトを返す式。

パラメーター

名前 必須 / オプション データ型 説明
Field 省略可能 String 検索するフィールドの名前を指定します。
Test 省略可能 String フィールド の間の比較の種類。 比較文字列の 1 つを指定できます。
省略可能 バリアント型 Field で指定されたフィールドの値と比較する値。
Replacement 省略可能 バリアント型 "" (空の文字列) を使用して、TestValue で指定されたテストを満たすフィールドをクリアします。
ReplaceAll オプション バリアント型 True の 場合 Valueのすべての出現箇所を交換してください。 False だけの場合、最初に見つかった位置を交換してください。 既定値は False です。
Next オプション バリアント型 True の 場合は検索条件の検索が下方向に一致する次の出現箇所を。 False とプロジェクトの次の出現箇所に検索します。 既定値は True です。
MatchCase 省略可能 バリアント型 True の 場合、検索は大文字小文字を区別します。 既定値は False です。
FieldID 省略可能 バリアント型 フィールド識別番号には、 PjField 定数のいずれかを指定できます。 FieldID 引数は Field の値よりも優先されます。
TestID 省略可能 バリアント型 テスト識別番号は、 PjComparison クラスの定数のいずれかです。 TestID は、任意の Test 値よりも優先されます。
SearchAllFields オプション バリアント型 True の場合は、使用可能なすべてのフィールドで指定した値を置き換えます。 既定値は False です。 SearchAllFieldsは、 FieldFieldIDよりも優先されます。

比較文字列

比較文字列 説明
"と等しい" 引数 Field の値は、引数 Value の値と等しい。
"と等しくない" 引数 Field の値は、引数 Value の値と等しくない。
"より大きい" 引数 Field の値は、引数 Value の値より大きい。
"以上" 引数 Field の値は、引数 Value の値より大きいか等しい。
"より小さい" 引数 Field の値は、引数 Value の値より小さい。
"以下" 引数 Field の値は、引数 Value の値より小さいか等しい。
"の範囲内" 引数 Field の値は、引数 Value の値の範囲内にある。
"の範囲外" 引数 Field の値は、引数 Value の値の範囲内にない。
"を含む" フィールド が含まれています。
"を含まない" フィールド が含まれていません。
"と一致するものを含む" フィールド には正確な が含まれています。

戻り値

ブール型 (Boolean)

True場合は、置換が実行されます。それ以外の場合、 False

注釈

引数を指定しない、またはフィールドテストおよび値を指定せずに ReplaceEx メソッドを使用すると、前の状態のオプションが設定されている [置換] ダイアログ ボックスが表示されます。 SearchAllFieldsTrue に設定した場合、プログラムによる使用には、フィールドテストおよび値パラメーターの値が引き続き必要です。

次の例のどちらの行も、利用可能なすべてのフィールドで "Bad" を "Good" に置換します。

Sub Bad2Good() 
    ReplaceEx Field:="Name", Test:="contains", Value:="Bad", Replacement:="Good", _ 
        ReplaceAll:=True, SearchAllFields:=True 
    ReplaceEx Field:="xx", Test:="xx", TestID:=pjCompareContains, Value:="Bad", Replacement:="Good", _ 
        ReplaceAll:=True, SearchAllFields:=True 
End Sub

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。