TextSelection.FindPattern-Methode
Aktualisiert: November 2007
Sucht nach dem angegebenen Muster vom aktiven Punkt bis zum Ende des Dokuments.
Namespace: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)
'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
Pattern
Typ: System.StringErforderlich. Der zu suchende Text.
vsFindOptionsValue
Typ: System.Int32Einer 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.
Typ: System.Boolean
Ein boolescher Wert, der true lautet, wenn das Muster gefunden wurde, und andernfalls false.
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.
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
- 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.