TextSelection.FindPattern-Methode

Článek
08/23/2008

Aktualisiert: November 2007

Sucht nach dem angegebenen Muster vom aktiven Punkt bis zum Ende des Dokuments.

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

Syntax

'Declaration
Function FindPattern ( _
    Pattern As String, _
    vsFindOptionsValue As Integer, _
    <OutAttribute> ByRef Tags As TextRanges _
) As Boolean
'Usage
Dim instance As TextSelection
Dim Pattern As String
Dim vsFindOptionsValue As Integer
Dim Tags As TextRanges
Dim returnValue As Boolean

returnValue = instance.FindPattern(Pattern, _
    vsFindOptionsValue, Tags)

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

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

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

Parameter

Pattern
Typ: System.String

Erforderlich. Der zu suchende Text.

vsFindOptionsValue
Typ: System.Int32

Einer der vsFindOptions-Werte.

Tags
Typ: EnvDTE.TextRanges%

Optional. Wenn das gesuchte Muster ein regulärer Ausdruck ist und markierte Unterausdrücke enthält, umfasst das Tags-Argument eine Auflistung von TextRange-Objekten, und zwar jeweils eines für jeden markierten Unterausdruck.

Rückgabewert

Typ: System.Boolean

Ein boolescher Wert, der true lautet, wenn das Muster gefunden wurde, und andernfalls false.

Hinweise

FindPattern sucht vom Bearbeitungspunkt bis zum Ende des Dokuments nach dem angegebenen Textmuster. Eines der Flags steuert, ob die Suche am Anfang des Dokuments beginnt oder nicht. Das Muster kann ein regulärer oder sonstiger Ausdruck sein. Der Rückgabewert gibt an, ob das Muster gefunden wurde. Wenn das Muster gefunden wurde, wird der Bearbeitungspunkt an den Anfang der Übereinstimmung verschoben. Andernfalls wird die Bearbeitungsposition nicht geändert.

Wenn ein Endpunkt angegeben und das Muster gefunden wurde, verschiebt FindPattern den Endpunkt an das Ende des gefundenen Musters.

Wenn das gesuchte Muster ein regulärer Ausdruck ist und markierte Unterausdrücke enthält, gibt das Tags-Argument eine Auflistung von TextRange-Objekten zurück, und zwar jeweils eines für jeden markierten Unterausdruck.

Beispiele

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

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

TextSelection-Schnittstelle

TextSelection-Member

EnvDTE-Namespace

Sdílet prostřednictvím