Método TextSelection.FindPattern

Artigo
05/17/2015

Pesquisas para o padrão dado par ativo ao final do documento.

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

Sintaxe

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

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

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

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

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

Parâmetros

Pattern
Tipo: String

Obrigatório. O texto a localizar.

vsFindOptionsValue
Tipo: Int32

Um dos valores de vsFindOptions.

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: Boolean
Um valor Booleano que indica true se o padrão é encontrado, false se não.

Comentários

FindPattern procura por padrão dado de texto do ponto de edição ao final do documento. Um dos sinalizadores 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 está 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()
   ' Before running this example, open a text document.
   Dim objSel As TextSelection = DTE.ActiveDocument.Selection

   ' Advance to the next Visual Basic function beginning or end by 
   ' searching for  "Sub" with white space before and after it.
   If objSel.FindPattern(":WhSub:Wh", vsFindOptions.vsFindOptionsRegularExpression) Then
      ' Select the entire line.
      objSel.SelectLine()
   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

TextSelection Interface

Namespace EnvDTE

Partilhar via