EditPoint.FindPattern(String, Int32, EditPoint, TextRanges) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отыскивает соответствия заданному шаблону в выделенном тексте.
[System.Runtime.InteropServices.DispId(151)]
public bool FindPattern (string Pattern, int vsFindOptionsValue = 0, out EnvDTE.EditPoint EndPoint = default, out EnvDTE.TextRanges Tags = default);
[<System.Runtime.InteropServices.DispId(151)>]
abstract member FindPattern : string * int * EditPoint * TextRanges -> bool
Public Function FindPattern (Pattern As String, Optional vsFindOptionsValue As Integer = 0, Optional ByRef EndPoint As EditPoint = Nothing, Optional ByRef Tags As TextRanges = Nothing) As Boolean
Параметры
- Pattern
- String
Обязательный. Текст, который необходимо найти.
- vsFindOptionsValue
- Int32
Необязательный параметр. Константа vsFindOptions, указывающая тип выполняемой операции поиска. Константное значение vsFindOptionsMatchInHiddenText неприменимо к методу, потому что FindPattern(String, Int32, EditPoint, TextRanges) ищет по всему тексту, включая скрытый текст.
- EndPoint
- EditPoint
Необязательный параметр. Объект EditPoint, представляющий точку, которая должна быть перенесена в конец шаблона.
- Tags
- TextRanges
Необязательный параметр. Если сопоставленный шаблон является регулярным выражением, содержащим вложенные выражения с тегами, аргумент Tags содержит коллекцию TextRange объектов, по одной для каждой части выражения, заключенного в теги.
Возвращаемое значение
true — если шаблон найден; false — в противном случае.
- Атрибуты
Примеры
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
Комментарии
FindPattern выполняет поиск по заданному тексту (включая скрытые) для данного текстового шаблона, от точки редактирования до конца документа. Один флаг определяет, начинается ли поиск с начала документа. Шаблон может быть обычным или другим выражением. Возвращаемое значение указывает, найден ли шаблон. Если шаблон найден, точка редактирования перемещается в начало совпадения. В противном случае изменение расположения не изменится.
Если указана конечная точка и найден шаблон, то FindPattern Конечная точка перемещается в конец найденного шаблона.
Если сопоставленный шаблон является регулярным выражением и содержит вложенные выражения с тегами, то Tags аргумент возвращает коллекцию TextRange объектов, по одной для каждой части выражения с тегами.