Interface Find

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

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

Sintaxe

'Declaração
<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

O tipo Find expõe os membros a seguir.

Propriedades

  Nome Descrição
Propriedade pública Action Obtém ou define como localizar, como localizar a próxima correspondência, localizar todos os, localizar e substituir e assim por diante.
Propriedade pública Backwards Obtém ou define um valor indicando se a pesquisa é realizada para trás da posição atual.
Propriedade pública DTE Obtém o objeto de extensibilidade de nível superior.
Propriedade pública FilesOfType Obtém ou define a extensão de arquivo para os arquivos a serem pesquisados.
Propriedade pública FindWhat Obtém ou define o padrão para localizar ou texto.
Propriedade pública KeepModifiedDocumentsOpen Obtém ou define um valor que indica se ou não modificado documentos permanecem abertos após um Replace operação.
Propriedade pública MatchCase Obtém ou define um valor que indica se a pesquisa diferencia maiúsculas de minúsculas.
Propriedade pública MatchInHiddenText Obtém ou define um valor indicando se o texto oculto é incluído na pesquisa.
Propriedade pública MatchWholeWord Obtém ou define um valor indicando se a pesquisa somente palavras inteiras.
Propriedade pública Parent Obtém o objeto pai imediato de um Find objeto.
Propriedade pública PatternSyntax Obtém ou define a sintaxe usada para especificar o padrão de pesquisa.
Propriedade pública ReplaceWith Obtém ou define o texto de substituição para uma operação de substituição.
Propriedade pública ResultsLocation Obtém ou define o local onde os resultados são mostrados em uma operação de pesquisa em massa.
Propriedade pública SearchPath Obtém ou define uma lista de diretórios para uma operação Localizar em arquivos.
Propriedade pública SearchSubfolders Obtém ou define um valor indicando se as subpastas estão incluídas em um Search operação.
Propriedade pública Target Obtém ou define o destino da operação de pesquisa, como, por exemplo, todos os documentos, arquivos, o documento ativo e assim por diante.

Início

Métodos

  Nome Descrição
Método público Execute Realiza uma pesquisa de acordo com as opções definidas para o Find objeto.
Método público FindReplace Executa uma operação de localização ou substituição com base nos argumentos do método, sem afetar as opções definidas para o Find.

Início

Comentários

O Find objeto lhe permite procurar e substituir texto em locais do ambiente que dê suporte a operações, tais como o editor de código.

Destina-se principalmente para fins de gravação de macro. Macro do editor, gravando os usos do mecanismo Find em vez de TextSelection.FindPattern para que você pode descobrir o modelo global da funcionalidade de busca e geralmente é mais útil que usando o TextSelection o objeto para operações como localizar-em-arquivos.

O ambiente de Visual Studio tem um estado de localizar global que é compartilhado entre todas as suas ferramentas que fornece recursos de pesquisa. Por exemplo, todos os Visual Studio elementos compartilham o histórico de padrões de pesquisa usado durante uma sessão e se o próximo Find operação para abrir documentos deve ser ou para trás. O Find Propriedades do objeto interagem e controlam o estado global localizar. Ao definir propriedades no Find o objeto, também, definir o estado global localizar. Se os usuários executarem uma Find operação através do ambiente, o Find objeto reflete o tipo de pesquisa executados por eles. Como a execução de código de automação sincronia com o segmento de interface do usuário do ambiente, você não precisa definir algumas das propriedades e fazer com que o usuário realizar uma pesquisa antes de chamar o Execute.

O Execute método executa uma Find operação com base nas configurações da Find objeto. Você também pode passar argumentos para o FindReplace método para realizar uma pesquisa sem afetar o estado global localizar. É importante para clientes de automação poder realizar uma pesquisa sem afetar o estado global de 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

Namespace EnvDTE