Range.Find Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Busca información específica en un rango y devuelve un Range objeto que representa la primera celda donde se encuentra esa información.
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
Parámetros
- What
- Object
Objeto obligatorio. El texto que se va a buscar. Puede ser una cadena o cualquier tipo de datos de Microsoft Excel.
- After
- Object
Objeto opcional. La celda después de la que quiere que se inicie la búsqueda. Se corresponde a la posición de la celda activa cuando se realiza una búsqueda desde la interfaz de usuario. Tenga en cuenta que After debe ser una sola celda del rango. Recuerde que la búsqueda comienza after
esta celda; la celda especificada no se busca hasta que el método se ajuste a esta celda. Si no especifica este argumento, la búsqueda se inicia después de la celda de la esquina superior izquierda del rango.
- LookIn
- Object
Objeto opcional. Tipo de información.
- LookAt
- Object
Objeto opcional. Puede ser una de las siguientes XlLookAt constantes: xlWhole o xlPart.
- SearchOrder
- Object
Objeto opcional. Puede ser una de las siguientes XlSearchOrder constantes: xlByRows o xlByColumns.
- SearchDirection
- XlSearchDirection
Opcional XlSearchDirection. Dirección de la búsqueda. Puede ser una de estas constantes XlSearchDirection:xlNextdefault
xlPrevious
- MatchCase
- Object
Objeto opcional. Si es True, la búsqueda distingue entre mayúsculas y minúsculas. El valor predeterminado es False.
- MatchByte
- Object
Objeto opcional. Solo se usa si ha seleccionado o instalado la compatibilidad con idiomas de doble byte. True para que los caracteres de doble byte coincidan solo con caracteres de doble byte; False para que los caracteres de doble byte coincidan con sus equivalentes de un solo byte.
- SearchFormat
- Object
Objeto opcional. Formato de la búsqueda.
Devoluciones
Comentarios
Este método devuelve Nothing si no se encuentra ninguna coincidencia.
Este método no afecta a la selección ni a la celda activa.
La configuración de LookIn
, LookAt
, SearchOrder
y MatchByte
se guarda cada vez que se usa este método. Si no especifica valores para estos argumentos la próxima vez que llame al método, se usarán los valores guardados. Establecer los argumentos siguientes cambia la configuración del cuadro de diálogo Buscar, y cambiar la configuración del cuadro de diálogo Buscar cambia los valores guardados que se usan si se omiten los argumentos. Para evitar problemas, establezca estos argumentos de forma explícita cada vez que use este método.
Puede usar los FindNext(Object) métodos y FindPrevious(Object) para repetir la búsqueda.
Cuando la búsqueda llega al final del rango de búsqueda especificado, vuelve al principio del rango. Para detener una búsqueda cuando se produzca esta situación, guarde la dirección de la primera celda que se encuentre y, después, pruebe la dirección de cada celda sucesiva que se haya encontrado con esta dirección guardada.
Para buscar celdas que coincidan con diseños más complicados, use una instrucción For Each...Next con el operador Like.