Interface Find2

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

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

Sintaxe

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

O tipo Find2 expõe os membros a seguir.

Propriedades

	Nome	Descrição
	Action	(Herdado de Find.)
	Action	Obtém ou define como localizar, como localizar a próxima correspondência, localizar todos os, localizar e substituir e assim por diante.
	Backwards	(Herdado de Find.)
	Backwards	Obtém ou define um valor que indica se a pesquisa é realizada com versões anteriores da posição atual.
	DTE	(Herdado de Find.)
	DTE	Obtém o objeto de extensibilidade de nível superior.
	FilesOfType	(Herdado de Find.)
	FilesOfType	Obtém ou define a extensão de arquivo para os arquivos a serem pesquisados.
	FindWhat	(Herdado de Find.)
	FindWhat	Obtém ou define o padrão para localizar ou texto.
	KeepModifiedDocumentsOpen	(Herdado de Find.)
	KeepModifiedDocumentsOpen	Obtém ou define um valor que indica se ou não modificado documentos permanecem abertos após uma operação de substituição.
	MatchCase	(Herdado de Find.)
	MatchCase	Obtém ou define um valor que indica se a pesquisa deve diferenciar maiúsculas de minúsculas.
	MatchInHiddenText	(Herdado de Find.)
	MatchInHiddenText	Obtém ou define um valor indicando se o texto oculto está incluído na pesquisa.
	MatchWholeWord	(Herdado de Find.)
	MatchWholeWord	Obtém ou define um valor que indica se a pesquisa coincide somente palavras inteiras.
	Parent	(Herdado de Find.)
	Parent	Obtém o objeto pai imediato de um Find objeto.
	PatternSyntax	(Herdado de Find.)
	PatternSyntax	Obtém ou define a sintaxe usada para especificar o padrão de pesquisa.
	ReplaceWith	(Herdado de Find.)
	ReplaceWith	Obtém ou define o texto de substituição para uma operação de substituição.
	ResultsLocation	(Herdado de Find.)
	ResultsLocation	Obtém ou define o local onde os resultados são mostrados em uma operação de pesquisa em massa.
	SearchPath	(Herdado de Find.)
	SearchPath	Obtém ou define uma lista de diretórios a ser usado para uma operação de arquivos de localização.
	SearchSubfolders	(Herdado de Find.)
	SearchSubfolders	Obtém ou define um valor indicando se as subpastas estão incluídas em uma operação de pesquisa.
	Target	(Herdado de Find.)
	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.
	WaitForFindToComplete	Obtém ou define um valor indicando se um resultado de localização é retornado antes de continuar a execução.

Superior

Métodos

	Nome	Descrição
	Execute()	(Herdado de Find.)
	Execute()	Realiza uma pesquisa de acordo com as opções definidas para o Find objeto.
	FindReplace(vsFindAction, String, Int32, String, vsFindTarget, String, String, vsFindResultsLocation)	(Herdado de Find.)
	FindReplace(vsFindAction, String, Int32, String, vsFindTarget, String, String, vsFindResultsLocation)	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 objeto.

Superior

Comentários

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

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

Estado de localização global do ambiente Visual Studio é compartilhado entre todas as suas ferramentas e fornece recursos de pesquisa.Por exemplo, todos os elementos de Visual Studio 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 a frente ou para trás.O Find propriedades do objeto interagir e controlar o estado global de localização.Ao definir propriedades na Find de objeto, você também definir o estado global de localização.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 o código de automação de forma síncrona executa com o segmento de interface do usuário do ambiente, você não precisa se preocupar sobre como definir algumas propriedades e tendo o usuário realizar uma pesquisa antes de chamar o Execute.

O Execute método realiza uma Find operação com base nas configurações da Find objeto.Também é possível passar argumentos para o FindReplace método para realizar uma pesquisa sem afetar o global descobrir o estado.É importante para clientes de automação poder realizar uma pesquisa sem afetar o estado global de localização 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 EnvDTE80