Método EditPoint2.FindPattern

Artigo
05/17/2015

Localiza um padrão especificado de correspondência no texto selecionado.

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

Sintaxe

'Declaração
Function FindPattern ( _
    Pattern As String, _
    vsFindOptionsValue As Integer, _
    <OutAttribute> ByRef EndPoint As EditPoint, _
    <OutAttribute> ByRef Tags As TextRanges _
) As Boolean

bool FindPattern(
    string Pattern,
    int vsFindOptionsValue,
    out EditPoint EndPoint,
    out TextRanges Tags
)

bool FindPattern(
    [InAttribute] String^ Pattern, 
    [InAttribute] int vsFindOptionsValue, 
    [InAttribute] [OutAttribute] EditPoint^% EndPoint, 
    [InAttribute] [OutAttribute] TextRanges^% Tags
)

abstract FindPattern : 
        Pattern:string * 
        vsFindOptionsValue:int * 
        EndPoint:EditPoint byref * 
        Tags:TextRanges byref -> bool

function FindPattern(
    Pattern : String, 
    vsFindOptionsValue : int, 
    EndPoint : EditPoint, 
    Tags : TextRanges
) : boolean

Parâmetros

Pattern
Tipo: String

Necessário. O texto que você deseja localizar.

vsFindOptionsValue
Tipo: Int32

Opcional. Uma constante de vsFindOptions que indica o tipo de pesquisa para executar. O valor constante de vsFindOptionsMatchInHiddenText não se aplica a esse método como FindPattern pesquisa qualquer texto, incluindo o texto oculto.

EndPoint
Tipo: EditPoint%

Opcional. Um objeto de EditPoint que representa o ponto que deve ser movido no final do padrão correspondente.

Tags
Tipo: TextRanges%

Opcional. Se o padrão é correspondido uma expressão regular que contém subelementos expressões marcadas, o argumento de Tags contém uma coleção de objetos TextRange , um para cada subelemento expressão marcada.

Valor de retorno

Tipo: Boolean
true se o padrão for localizado; caso contrário, false.

Comentários

FindPattern pesquisa todo o texto oculto (inclusive) por padrão especificado do texto do ponto de extremidade à edição do documento. Um sinalizador controla se a pesquisa começará 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 está localizado. Se o padrão é encontrado, o ponto de edição é movido para o início da correspondência. Caso contrário, o local da edição é alterado.

Se um ponto de extremidade for fornecido e se o padrão encontrados, então FindPattern move o ponto de extremidade ao final do padrão localizado.

Se o padrão é correspondido uma expressão regular e contém subelementos expressões marcadas, o argumento de Tags retorna uma coleção de objetos TextRange , um para cada subelemento expressão marcada.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

EditPoint2 Interface

Namespace EnvDTE80

Compartilhar via