Interface Find2

Artigo
08/01/2011

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 indicando se a pesquisa é realizada para trás 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 indicando modificado ou não os 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 diferencia maiúsculas de minúsculas.
	MatchInHiddenText	(Herdado de Find.)
	MatchInHiddenText	Obtém ou define um valor indicando se o texto oculto é incluído na pesquisa.
	MatchWholeWord	(Herdado de Find.)
	MatchWholeWord	Obtém ou define um valor indicando se a pesquisa 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 para uma operação Localizar em arquivos.
	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.

Início

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 localizar ou substituir, com base nos argumentos do método, sem afetar as opções definidas para o Find objeto.

Início

Comentários

O Find objeto lhe permite localizar 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, a gravação de mecanismo usa Find em vez de TextSelection.FindPattern para que você pode descobrir a funcionalidade de localização global. Além disso, é geralmente mais úteis do que usando o TextSelection o objeto para operações como localizar-em-arquivos.

Estado de localizar global do ambiente de 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 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 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 com a definição de algumas propriedades e tendo o usuário a executar 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 EnvDTE80

Partilhar via