Interface Find

Artigo
10/26/2012

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
	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	Obtém ou define um valor que indica se a pesquisa é realizada com versões anteriores da posição atual.
	DTE	Obtém o objeto de extensibilidade de nível superior.
	FilesOfType	Obtém ou define a extensão de arquivo para os arquivos a serem pesquisados.
	FindWhat	Obtém ou define o padrão para localizar ou texto.
	KeepModifiedDocumentsOpen	Obtém ou define um valor que indica se ou não modificado documentos permanecem abertos após um Replace operação.
	MatchCase	Obtém ou define um valor que indica se a pesquisa deve diferenciar maiúsculas de minúsculas.
	MatchInHiddenText	Obtém ou define um valor indicando se o texto oculto está incluído na pesquisa.
	MatchWholeWord	Obtém ou define um valor que indica se a pesquisa coincide somente palavras inteiras.
	Parent	Obtém o objeto pai imediato de um Find objeto.
	PatternSyntax	Obtém ou define a sintaxe usada para especificar o padrão de pesquisa.
	ReplaceWith	Obtém ou define o texto de substituição para uma operação de substituição.
	ResultsLocation	Obtém ou define o local onde os resultados são mostrados em uma operação de pesquisa em massa.
	SearchPath	Obtém ou define uma lista de diretórios a ser usado para uma operação de arquivos de localização.
	SearchSubfolders	Obtém ou define um valor indicando se as subpastas estão incluídas em um Search operação.
	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.

Superior

Métodos

	Nome	Descrição
	Execute	Realiza uma pesquisa de acordo com as opções definidas para o Find objeto.
	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.

Superior

Comentários

O Find objeto permite procurar 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 e porque geralmente é mais útil que usando o TextSelection objeto para operações como arquivos de localização.

O ambiente de Visual Studio tem um estado de localização 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 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.Porque o código de automação de forma síncrona executa com o segmento de interface do usuário do ambiente, você não precisará definir algumas das propriedades e fazer com que 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 EnvDTE

Compartilhar via