Range.Find メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
範囲内の特定の情報を検索し、その情報が見つかった最初のセルを表すオブジェクトを返 Range します。
public Microsoft.Office.Interop.Excel.Range Find (object What, object After, object LookIn, object LookAt, object SearchOrder, Microsoft.Office.Interop.Excel.XlSearchDirection SearchDirection = Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext, object MatchCase, object MatchByte, object SearchFormat);
Public Function Find (What As Object, Optional After As Object, Optional LookIn As Object, Optional LookAt As Object, Optional SearchOrder As Object, Optional SearchDirection As XlSearchDirection = Microsoft.Office.Interop.Excel.XlSearchDirection.xlNext, Optional MatchCase As Object, Optional MatchByte As Object, Optional SearchFormat As Object) As Range
パラメーター
- What
- Object
必須 オブジェクト。 検索するデータです。 指定できるのは、文字列、または任意の Microsoft Excel のデータ型です。
- After
- Object
省略可能 なオブジェクト。 このセルの後から検索を開始します。 これは、ユーザー インターフェイスから検索が実行されたときにアクティブなセルの場所に対応しています。 After は範囲内の 1 つのセルである必要があることに注意してください。 検索はこのセルを after
開始します。指定されたセルは、メソッドがこのセルに折り返されるまで検索されません。 この引数を指定しない場合、検索は範囲の左上隅にあるセルの後から開始されます。
- LookIn
- Object
省略可能 なオブジェクト。 情報の種類。
- SearchOrder
- Object
省略可能 なオブジェクト。 XlSearchOrderxlByRows または xlByColumns のいずれかの定数を指定できます。
- SearchDirection
- XlSearchDirection
省略可能 XlSearchDirectionです。 検索の方向を指定します。 これらの XlSearchDirection 定数の 1 つを指定できます:xlNextdefault
xlPrevious
- MatchCase
- Object
省略可能 なオブジェクト。 大文字と小文字を区別するには、 True を指定します。 既定値は False です。
- MatchByte
- Object
省略可能 なオブジェクト。 2 バイト言語のサポートを選択またはインストールした場合にのみ使用されます。 2 バイト文字が 2 バイト文字と一致する場合は True。2 バイト文字が 1 バイトの等価文字と一致する場合は False。
- SearchFormat
- Object
省略可能 なオブジェクト。 検索の書式を指定します。
戻り値
注釈
一致するデータが見つからなかった場合、このメソッドは Nothing を返します。
このメソッドは、選択範囲やアクティブなセルには影響しません。
、LookAt
、SearchOrder
および MatchByte
のLookIn
設定は、このメソッドを使用するたびに保存されます。 次に メソッドを呼び出したときにこれらの引数の値を指定しない場合は、保存された値が使用されます。 これらの引数を設定すると、[検索] ダイアログ ボックスの設定が変更され、また、[検索] ダイアログ ボックスで設定を変更すると、引数を省略した場合に使用される保存された値が変更されます。 問題を回避するには、このメソッドを使用するたびに、これらの引数を明示的に設定します。
メソッドと FindPrevious(Object) メソッドをFindNext(Object)使用して、検索を繰り返すことができます。
検索が指定された検索範囲の最後に達すると、範囲の最初に戻ります。 最初に戻ったときに検索を停止するには、最初に見つかったセルの位置を保存しておき、セルが見つかるたびに、その位置と保存しておいた位置を比較します。
より複雑なパターンに一致するセルを見つけるには、For Each...Next ステートメントを Like演算子と共に使用します。