Compartir a través de


Find (Interfaz)

Admite operaciones Find generales de texto para documentos y archivos del entorno.

Espacio de nombres:  EnvDTE
Ensamblado:  EnvDTE (en EnvDTE.dll)

Sintaxis

'Declaración
<GuidAttribute("40D4B9B6-739B-4965-8D65-692AEC692266")> _
Public Interface Find
[GuidAttribute("40D4B9B6-739B-4965-8D65-692AEC692266")]
public interface Find
[GuidAttribute(L"40D4B9B6-739B-4965-8D65-692AEC692266")]
public interface class Find
[<GuidAttribute("40D4B9B6-739B-4965-8D65-692AEC692266")>]
type Find =  interface end
public interface Find

El tipo Find expone los siguientes miembros.

Propiedades

  Nombre Descripción
Propiedad pública Action Obtiene o establece cómo buscar. Por ejemplo, buscar la siguiente coincidencia, buscar todo, buscar y reemplazar, etc.
Propiedad pública Backwards Obtiene o establece un valor que indica si la búsqueda tiene lugar hacia atrás desde la ubicación actual.
Propiedad pública DTE Obtiene el objeto de extensibilidad de nivel superior.
Propiedad pública FilesOfType Obtiene o establece las extensiones de los archivos que se van a buscar.
Propiedad pública FindWhat Obtiene o establece el texto o el modelo que se va a buscar.
Propiedad pública KeepModifiedDocumentsOpen Obtiene o establece un valor que indica si los documentos modificados permanecerán o no abiertos después de una operación Replace.
Propiedad pública MatchCase Obtiene o establece un valor que indica si la búsqueda distingue entre mayúsculas y minúsculas.
Propiedad pública MatchInHiddenText Obtiene o establece un valor que indica si el texto oculto está incluido en la búsqueda.
Propiedad pública MatchWholeWord Obtiene o establece un valor que indica si se buscan sólo palabras completas.
Propiedad pública Parent Obtiene el objeto primario inmediato de un objeto Find.
Propiedad pública PatternSyntax Obtiene o establece la sintaxis usada para especificar el modelo de búsqueda.
Propiedad pública ReplaceWith Obtiene o establece el texto de reemplazo para una operación de reemplazo.
Propiedad pública ResultsLocation Obtiene o establece la ubicación donde se muestran los resultados en una operación de búsqueda masiva.
Propiedad pública SearchPath Obtiene o establece una lista de directorios que se utilizarán para una operación de búsqueda en archivos.
Propiedad pública SearchSubfolders Obtiene o establece un valor que indica si las subcarpetas están incluidas o no en una operación Search.
Propiedad pública Target Obtiene o establece el destino de la operación de búsqueda, como todos los documentos abiertos, los archivos, el documento activo, etc.

Arriba

Métodos

  Nombre Descripción
Método público Execute Realiza una búsqueda basada en las opciones establecidas para el objeto Find.
Método público FindReplace Realiza una operación Buscar o Reemplazar de acuerdo con los argumentos del método, sin afectar a las opciones establecidas para el objeto Find.

Arriba

Comentarios

El objeto Find permite buscar y reemplazar texto en lugares del entorno que permiten estas operaciones, como el Editor de código.

Está diseñado principalmente para fines de grabación de macros. El mecanismo de grabación de macros del editor utiliza Find en lugar de TextSelection.FindPattern de forma que sea posible detectar la funcionalidad de búsqueda global y porque suele ser más útil que utilizar el objeto TextSelection para operaciones como Buscar en archivos.

El entorno de Visual Studio tiene un estado de búsqueda global compartido en todas sus herramientas que proporciona características de búsqueda. Por ejemplo, todos los elementos de Visual Studio comparten el historial de modelos de búsqueda usados durante una sesión y si la siguiente operación Find para los documentos abiertos debe ser hacia delante o hacia atrás. Las propiedades del objeto Find interactúan con el estado de búsqueda global y efectúan su seguimiento. Al establecer las propiedades del objeto Find, también se establece el estado global de búsqueda. Si los usuarios realizan una operación Find en el entorno, el objeto Find refleja el tipo de búsqueda efectuado. Puesto que el código de automatización se ejecuta sincrónicamente con el subproceso de interfaz de usuario del entorno, no es necesario establecer algunas de las propiedades y hacer que el usuario realice una búsqueda antes de poder llamar a Execute.

El método Execute realiza una operación Find basada en la configuración del objeto Find. También se pueden pasar argumentos al método FindReplace para realizar una búsqueda sin que afecte al estado de búsqueda global. Es importante para los clientes de automatización poder realizar una búsqueda sin afectar al estado global de búsqueda ni interferir con el modelo que posee el usuario final del estado del entorno.

Ejemplos

Sub FindExample()
   Dim objTextDoc As TextDocument
   Dim objEditPt As EditPoint
   Dim iCtr As Integer
   Dim objFind As Find

   ' Create a new text file.
   DTE.ItemOperations.NewFile("General\Text File")

   ' Get a handle to the new document and create an EditPoint.
   objTextDoc = DTE.ActiveDocument.Object("TextDocument")
   objEditPt = objTextDoc.StartPoint.CreateEditPoint
   objFind = objTextDoc.DTE.Find

   ' Insert ten lines of text.
   For iCtr = 1 To 10
      objEditPt.Insert("This is a test." & Chr(13))
   Next iCtr

   ' Set the find options.
   objFind.Action = vsFindAction.vsFindActionReplaceAll
   objFind.Backwards = False
   objFind.FilesOfType = "*.txt"
   objFind.FindWhat = "test"
   objFind.KeepModifiedDocumentsOpen = True
   objFind.MatchCase = False
   objFind.MatchInHiddenText = False
   objFind.MatchWholeWord = True
   objFind.PatternSyntax = vsFindPatternSyntax.vsFindPatternSyntaxLiteral
   objFind.ReplaceWith = "NEW THING"
   objFind.ResultsLocation = vsFindResultsLocation.vsFindResultsNone
   objFind.SearchPath = "c:\temp"
   objFind.SearchSubfolders = False
   objFind.Target = vsFindTarget.vsFindTargetCurrentDocument
   ' Perform the Find operation.
   objFind.Execute()
End Sub

Vea también

Referencia

EnvDTE (Espacio de nombres)