EditPoint.FindPattern, méthode

Article
08/10/2011

Recherche un modèle donné dans le texte sélectionné.

Espace de noms : EnvDTE
Assembly : EnvDTE (dans EnvDTE.dll)

Syntaxe

'Déclaration
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

Paramètres

Pattern
Type : System.String
Obligatoire.Texte à trouver.

vsFindOptionsValue
Type : System.Int32
Facultatif.Constante vsFindOptions indiquant le type de recherche à effectuer.La valeur de constante vsFindOptionsMatchInHiddenText ne s'applique pas à cette méthode parce que FindPattern recherche tout le texte, y compris le texte masqué.

EndPoint
Type : EnvDTE.EditPoint%
Facultatif.Objet EditPoint représentant le point à déplacer jusqu'à la fin du modèle de texte trouvé.

Tags
Type : EnvDTE.TextRanges%
Facultatif.Si le modèle trouvé est une expression régulière contenant des sous-expressions avec balises, l'argument Tags contient une collection d'objets TextRange, un pour chaque sous-expression avec balises.

Valeur de retour

Type : System.Boolean
true si le modèle est trouvé ; sinon false.

Notes

FindPattern recherche tout le texte (y compris le texte masqué) du modèle de texte donné depuis le point d'édition jusqu'à la fin du document. Un indicateur détermine si la recherche commence au début du document. Le modèle peut être une expression régulière ou autre. La valeur retournée indique si le modèle a été trouvé. S'il a été trouvé, le point d'édition se place au début du texte correspondant. Sinon, il ne change pas de position.

Si un point de terminaison est fourni et que la recherche aboutit, FindPattern place ce point à la fin du modèle trouvé.

Si le modèle correspondant est une expression régulière contenant des sous-expressions avec balises, l'argument Tags retourne une collection d'objets TextRange, un pour chaque sous-expression avec balises.

Exemples

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

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

EditPoint Interface

EnvDTE, espace de noms

Partager via