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
オプションの オブジェクト。 定数として、xlByRows または xlByColumns のいずれかをXlSearchOrder指定できます。
- SearchDirection
- XlSearchDirection
オプションの XlSearchDirection。 検索の方向を指定します。 次のいずれかの XlSearchDirection 定数を指定します。xlNextdefaultxlPrevious
- MatchCase
- Object
オプションの オブジェクト。 大文字と小文字を区別するには、 True を指定します。 既定値は False です。
- MatchByte
- Object
オプションの オブジェクト。 2 バイト言語サポートを選択またはインストールした場合にのみ使用されます。 2 バイト文字が 2 バイト文字のみに一致する場合は true。2 バイト文字が対応する 1 バイト文字と一致する場合は false。
- SearchFormat
- Object
オプションの オブジェクト。 検索の書式を指定します。
返品
注釈
一致するデータが見つからなかった場合、このメソッドは Nothing を返します。
このメソッドは、選択範囲やアクティブ セルには影響しません。
この方法を使用するたびに、 LookIn、 LookAt、 SearchOrder、および MatchByte の設定が保存されます。 これらの引数の値を指定しないと、次にメソッドを呼び出すときに、保存された値が使用されます。 これらの引数を設定すると、[検索] ダイアログ ボックスの設定が変更され、また、[検索] ダイアログ ボックスで設定を変更すると、引数を省略した場合に使用される保存された値が変更されます。 問題を回避するには、このメソッドを使用するたびに、これらの引数を明示的に設定します。
検索を繰り返すには、 FindNext(Object) メソッドと FindPrevious(Object) メソッドを使用できます。
検索が指定された検索範囲の最後に達すると、範囲の最初に戻ります。 最初に戻ったときに検索を停止するには、最初に見つかったセルの位置を保存しておき、セルが見つかるたびに、その位置と保存しておいた位置を比較します。
より複雑なパターンに一致するセルを見つけるには、For Each...Next ステートメントを Like演算子と共に使用します。