Metodo EditPoint.FindPattern

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

Vedere anche

Riferimenti

EditPoint Interfaccia

Spazio dei nomi EnvDTE