Find2 (Interfaz)

Artículo
05/17/2015

Admite operaciones Find generales de búsqueda de texto en el entorno, en documentos y archivos.

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

Sintaxis

'Declaración
<GuidAttribute("01568308-5B2A-4F30-8D0A-E10EE0F28F4A")> _
Public Interface Find2 _
    Inherits Find

[GuidAttribute("01568308-5B2A-4F30-8D0A-E10EE0F28F4A")]
public interface Find2 : Find

[GuidAttribute(L"01568308-5B2A-4F30-8D0A-E10EE0F28F4A")]
public interface class Find2 : Find

[<GuidAttribute("01568308-5B2A-4F30-8D0A-E10EE0F28F4A")>]
type Find2 =  
    interface 
        interface Find 
    end

public interface Find2 extends Find

El tipo Find2 expone los siguientes miembros.

Propiedades

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

Arriba

Métodos

	Nombre	Descripción
	Execute	Realiza una búsqueda basada en las opciones establecidas para el objeto Find.
	FindReplace	Realiza una operación de búsqueda o reemplazo de acuerdo con los argumentos del método, sin que afecte a las opciones establecidas para el objeto Find.

Arriba

Comentarios

El objeto Find permite buscar y reemplazar texto en lugares del entorno que admiten 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 para que pueda detectar la funcionalidad de búsqueda global. Además, generalmente es más útil que utilizar el objeto TextSelection para operaciones tales como buscar en archivos.

El entorno de Visual Studio tiene un estado de búsqueda global compartido en todas sus herramientas que proporciona funcionalidades 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. Dado que el código de automatización se ejecuta sincrónicamente con el subproceso de la interfaz de usuario del entorno, no es necesario preocuparse por establecer ciertas propiedades o hacer que el usuario realice una búsqueda para 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

EnvDTE80 (Espacio de nombres)

Compartir a través de