Metodo EditPoint.FindPattern

Articolo
10/30/2012

Trova il testo corrispondente a un criterio di ricerca nel testo selezionato.

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

Sintassi

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

Parametri

Pattern
Tipo: System.String
Necessario.Il testo che si desidera trovare.

vsFindOptionsValue
Tipo: System.Int32
Opzionale.Costante vsFindOptions che indica il tipo di ricerca da eseguire.Il valore della costante vsFindOptionsMatchInHiddenText non è applicabile a questo metodo, perché il metodo FindPattern esegue la ricerca in tutto il testo, compreso quello nascosto.

EndPoint
Tipo: EnvDTE.EditPoint%
Opzionale.Oggetto EditPoint che rappresenta il punto da spostare alla fine del criterio di ricerca.

Tags
Tipo: EnvDTE.TextRanges%
Opzionale.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: System.Boolean
true se viene trovato il criterio; in caso contrario false.

Note

Il metodo FindPattern cerca il testo corrispondente al criterio di ricerca specificato in tutto il testo, compreso quello nascosto, partendo 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 il testo corrispondente viene trovato, 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()
   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

Sicurezza di .NET Framework

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

Vedere anche

Riferimenti

EditPoint Interfaccia

Spazio dei nomi EnvDTE

Condividi tramite