Método EditPoint.FindPattern

Artigo
10/26/2012

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

Namespace: EnvDTE
Assembly: EnvDTE (em EnvDTE.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: System.String
Obrigatório.O texto que você deseja localizar.

vsFindOptionsValue
Tipo: System.Int32
Opcional.Uma constante de vsFindOptions que indica o tipo de pesquisa para executar.O valor constante de vsFindOptionsMatchInHiddenText não se aplica a este método porque FindPattern procurar qualquer texto, incluindo texto oculto.

EndPoint
Tipo: EnvDTE.EditPoint%
Opcional.Um objeto de EditPoint que representa o ponto que deve ser movido para o final do padrão correspondente.

Tags
Tipo: EnvDTE.TextRanges%
Opcional.Se o padrão correspondente é uma expressão regular que contém subexpressões etiquetadas, então o argumento de Tags contém uma coleção de objetos de TextRange , um para cada etiquetada subexpressão.

Valor de retorno

Tipo: System.Boolean
true se o padrão é encontrado; caso contrário, false.

Comentários

FindPattern procurar qualquer texto (incluindo oculto por padrão) dado de texto do ponto de edição ao final do documento.Um sinalizador controla se inicia a pesquisa no início do documento.o padrão pode ser uma expressão normal ou outra.O valor de retorno indica se o padrão é localizado.Se o padrão é encontrado, o ponto de edição é movido para o início de correspondência.Caso contrário, o local de edição é inalterado.

Se um ponto final é fornecido e o padrão encontrado, então FindPattern move o ponto de extremidade ao final do padrão encontrado.

Se o padrão correspondente é uma expressão regular e contém subexpressões etiquetadas, então o argumento de Tags retorna uma coleção de objetos de TextRange , um para cada etiquetada subexpressão.

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áveis.

Consulte também

Referência

EditPoint Interface

Namespace EnvDTE

Compartilhar via