Interface Find

Artigo
08/01/2011

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

Início

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.

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

Compartilhar via