Metodo TextSelection.FindPattern

Articolo
05/16/2015

Cerca il criterio specificato dal punto attivo alla fine del documento.

Spazio dei nomi: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Sintassi

'Dichiarazione
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

Parametri

Pattern
Tipo: String

Obbligatorio. Il testo da trovare.

vsFindOptionsValue
Tipo: Int32

Uno dei valori di vsFindOptions.

Tags
Tipo: EnvDTE.TextRanges%

Parametro facoltativo. Se il criterio di ricerca è un'espressione regolare e contiene sottoespressioni con tag, l'argomento Tags conterrà una raccolta di oggetti TextRange, uno per ogni sottoespressione con tag.

Valore restituito

Tipo: Boolean
Valore Boolean true se viene trovato testo corrispondente al criterio di ricerca; in caso contrario false.

Note

FindPattern cerca il testo corrispondente al criterio di ricerca specificato a partire dal punto di modifica fino alla fine del documento. Uno dei flag determina se la ricerca deve essere eseguita partendo dall'inizio del documento. Il criterio di ricerca può essere un'espressione regolare o di altro tipo. Il valore restituito indica se il testo corrispondente è stato trovato. Se viene trovato, il punto di modifica verrà spostato all'inizio della corrispondenza. In caso contrario, la posizione di modifica non verrà cambiata.

Se viene fornito un endpoint e viene trovato testo corrispondente al criterio di ricerca, il metodo FindPattern sposta l'endpoint alla fine del testo trovato.

Se il criterio di ricerca è un'espressione regolare e contiene sottoespressioni con tag, l'argomento Tags restituirà una raccolta di oggetti TextRange, uno per ogni sottoespressione con tag.

Esempi

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

TextSelection Interfaccia

Spazio dei nomi EnvDTE

Condividi tramite