Share via


Interface Find

Oferece suporte a texto geral Find operações no ambiente de documentos e arquivos.

Namespace:  EnvDTE
Assembly:  EnvDTE (em EnvDTE. dll)

Sintaxe

<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

Comentários

O objeto de Find permite que você Pesquisar e substituir texto em locais do ambiente que oferece suporte a essas operações, como o editor de código.

Destina-se principalmente para fins de gravação de macro.Macro do editor gravação mecanismo usa Find em vez de TextSelection.FindPattern para que você pode descobrir que global localizar funcionalidade e porque geralmente é mais úteis que usando o objeto TextSelection de operações como localizar em arquivos.

O ambiente do Visual Studio possui um estado de localizar global que é compartilhado entre Tudo as suas ferramentas que fornece recursos de Pesquisar.Por exemplo, Tudo elementos de Visual Studio compartilhar o histórico de padrões de Pesquisar usados durante uma sessão e se a Avançar operação de Find para Abrir documentos devem ser encaminha ou para trás.Propriedades do objeto Find interagem com e controlar o estado global localizar.Quando você define propriedades no objeto Find, você também definir global Localizar estado.Se os usuários executar uma operação Find através do ambiente, o objeto Find reflete o tipo de Pesquisarr executados por eles.Como o código de automação é executado em sincronia com Thread de interface do usuário o ambiente, você não precisará definir algumas das propriedades e ter o usuário realizar umPesquisarr antes que você possa chamar o Execute.

O método Execute executa uma operação de Find com base nas configurações do objeto Find.Você também pode passar argumentos para o método FindReplace para realizar umPesquisarr sem afetar o global Localizar estado.É importante para clientes de automação para poder executar umPesquisarrr sem afetar o estado global localizar ou interferindo com o modelo do usuário final do estado do ambiente.

Exemplos

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

Consulte também

Referência

Find Membros

Espaço para nome EnvDTE