Range.Find Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Localiza informações específicas em um intervalo e retorna um objeto que representa a Range primeira célula onde essas informações são encontradas.
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 RangeParâmetros
- What
- Object
Objeto Obrigatório. A data a ser pesquisada. Pode ser uma cadeia de caracteres ou qualquer tipo de dados do Microsoft Excel.
- After
- Object
Objeto Opcional. A célula após a qual você deseja que a pesquisa seja iniciada. Isso corresponde à posição da célula ativa quando uma pesquisa é feita desde a interface do usuário. Observe que After precisa ser uma única célula no intervalo. Lembre-se de que a pesquisa inicia essa célula; a célula especificada não é pesquisada até que o método se envolva novamente after nessa célula. Se você não especificar esse argumento, a pesquisa será iniciada após a célula no canto superior esquerdo do intervalo.
- LookIn
- Object
Objeto Opcional. O tipo de informação.
- SearchOrder
- Object
Objeto Opcional. Pode ser uma das seguintes XlSearchOrder constantes: xlByRows ou xlByColumns.
- SearchDirection
- XlSearchDirection
Opcional XlSearchDirection . A direção da pesquisa. Pode ser uma destas constantes XlSearchDirection:xlNext default xlPrevious
- MatchCase
- Object
Objeto Opcional. True para fazer com que a pesquisa passe a diferenciar maiúsculas de minúsculas. O valor padrão é False.
- MatchByte
- Object
Objeto Opcional. Usado somente se você tiver selecionado ou instalado suporte a idiomas de byte duplo. True para ter caracteres de byte duplo que corresponderem apenas a caracteres de byte duplo; False para ter caracteres de byte duplo correspondentes aos seus equivalentes de byte único.
- SearchFormat
- Object
Objeto Opcional. O formato da pesquisa.
Retornos
Comentários
Esse método retornará Nothing se nenhuma correspondência for encontrada.
Esse método não afeta a seleção ou a célula ativa.
As configurações LookIn para , , e são LookAt SearchOrder MatchByte salvas sempre que você usa esse método. Se você não especificar valores para esses argumentos na próxima vez que chamar o método, os valores salvos serão usados. Definir esses argumentos alterará as configurações na caixa de diálogo Find e, ao alterar as configurações na caixa de diálogo Find, os valores salvos que são usados se você omitir os argumentos serão alterados. Para evitar problemas, defina estes argumentos explicitamente sempre que usar este método.
Você pode usar os FindNext(Object) métodos e para repetir a FindPrevious(Object) pesquisa.
Quando a pesquisa atingir o final do intervalo de pesquisa especificado, voltará ao início do intervalo. Para parar uma pesquisa quando isso acontecer, salve o endereço da primeira célula encontrada e então teste cada endereço de célula sucessivo encontrado em relação a esse endereço salvo.
Para localizar células que correspondem padrões mais complicados, use uma instrução For Each...Next com o operador Like.