EditPoint2.FindPattern 方法 (String, Int32, EditPoint%, TextRanges%)
在选定文本中查找给定的匹配模式。
命名空间： EnvDTE80
程序集： EnvDTE80（在 EnvDTE80.dll 中）
语法
声明
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
参数
- Pattern
类型：System.String
必选。要查找的文本。
- vsFindOptionsValue
类型：System.Int32
可选。一个 vsFindOptions 常数，该常数指示要执行的搜索类型。vsFindOptionsMatchInHiddenText 常数值不适用于此方法，这是由于 FindPattern 搜索所有文本（包括隐藏文本）。
- EndPoint
类型：EnvDTE.EditPoint%
可选。一个 EditPoint 对象，该对象表示将移动到匹配模式结尾的点。
- Tags
类型：EnvDTE.TextRanges%
可选。如果匹配的模式是一个正则表达式并且包含带标记的子表达式，则 Tags 参数包含 TextRange 对象的一个集合，对于每个带标记的子表达式都包含一个对象。
返回值
类型：System.Boolean
如果找到了匹配模式，则为 true；否则为 false。
备注
FindPattern 在编辑点到文档结尾的范围内搜索给定文本模式的所有文本（包括隐藏文本）。其中一个标志控制是否从文档开头开始搜索。模式可以是正则表达式，也可以是其他表达式。返回值指示是否找到了模式。如果找到了模式，编辑点就移动到匹配项的开始处。否则，编辑位置保持不变。
如果提供了终结点并且找到了模式，则 FindPattern 将终结点移动到找到的模式的结尾。
如果匹配的模式是一个正则表达式并且包含带标记的子表达式，则 Tags 参数返回 TextRange 对象的一个集合，为每个带标记的子表达式都返回一个对象。
示例
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
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。