TextSelection.FindPattern-Methode

Artikel
08/10/2011

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

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

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

abstract FindPattern : 
        Pattern:string * 
        vsFindOptionsValue:int * 
        Tags:TextRanges byref -> bool

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 aufweist, enthält 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

.NET Framework-Sicherheit

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

EnvDTE-Namespace

Freigeben über