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。
实现
EditPoint.FindPattern(String, Int32, EditPoint%, TextRanges%)
备注
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 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。