EditPoint.FindPattern(String, Int32, EditPoint, TextRanges) Método

Definição

Localiza um determinado padrão correspondente no texto selecionado.

[System.Runtime.InteropServices.DispId(151)]
public bool FindPattern (string Pattern, int vsFindOptionsValue = 0, out EnvDTE.EditPoint EndPoint = default, out EnvDTE.TextRanges Tags = default);
[<System.Runtime.InteropServices.DispId(151)>]
abstract member FindPattern : string * int * EditPoint * TextRanges -> bool
Public Function FindPattern (Pattern As String, Optional vsFindOptionsValue As Integer = 0, Optional ByRef EndPoint As EditPoint = Nothing, Optional ByRef Tags As TextRanges = Nothing) As Boolean

Parâmetros

Pattern
String

Obrigatórios. O texto que você deseja encontrar.

vsFindOptionsValue
Int32

Opcional. Uma vsFindOptions constante que indica o tipo de pesquisa a ser executada. O vsFindOptionsMatchInHiddenText valor da constante não se aplica a esse método porque o FindPattern(String, Int32, EditPoint, TextRanges) pesquisa todo o texto, incluindo o texto oculto.

EndPoint
EditPoint

Opcional. Um EditPoint objeto que representa o ponto a ser movido para o final do padrão correspondente.

Tags
TextRanges

Opcional. Se o padrão correspondente for uma expressão regular que contém subexpressões marcadas, o argumento marcas conterá uma coleção de TextRange objetos, um para cada subexpressão marcada.

Retornos

Boolean

true Se o padrão for encontrado; caso contrário, false .

Atributos

Exemplos

Sub FindPatternExample()  
   Dim objTextDoc As TextDocument  
   Dim objEditPt As EditPoint, iCtr As Integer  

   ' 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  

   ' Insert ten lines of text.  
   For iCtr = 1 To 10  
      objeditpt.Insert("This is a test." & Chr(13))  
   Next iCtr  
   objEditPt.StartOfDocument()  
   'Search for the word "test."  
   If objeditpt.FindPattern("test") = True Then  
      msgbox("Found the word.")  
   End If  
End Sub  

Comentários

FindPattern pesquisa todo o texto (incluindo ocultos) para o padrão de texto fornecido do ponto de edição até o fim do documento. Um sinalizador controla se a pesquisa começa no início do documento. O padrão pode ser uma expressão regular ou outra. O valor de retorno indica se o padrão foi encontrado. Se o padrão for encontrado, o ponto de edição será movido para o início da correspondência. Caso contrário, o local de edição não será alterado.

Se um ponto de extremidade for fornecido e o padrão for encontrado, o FindPattern moverá o ponto de extremidade para o final do padrão encontrado.

Se o padrão correspondente for uma expressão regular e contiver subexpressas marcadas, o Tags argumento retornará uma coleção de TextRange objetos, um para cada subexpressão marcada.

Aplica-se a