Find (Interfaz)
Actualización: noviembre 2007
Admite operaciones Find generales de texto para documentos y archivos del entorno.
Espacio de nombres: EnvDTE
Ensamblado: EnvDTE (en EnvDTE.dll)
Sintaxis
<GuidAttribute("40D4B9B6-739B-4965-8D65-692AEC692266")> _
Public Interface Find
Dim instance As Find
[GuidAttribute("40D4B9B6-739B-4965-8D65-692AEC692266")]
public interface Find
[GuidAttribute(L"40D4B9B6-739B-4965-8D65-692AEC692266")]
public interface class Find
public interface Find
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 de forma que sea posible descubrir 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 realizan un seguimiento del mismo. Al establecer las propiedades del objeto Find, también se establece el estado de búsqueda global. Si los usuarios realizan una operación Find en el entorno, el objeto Find refleja el tipo de búsqueda efectuada. 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 afectar 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