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 объектов, по одной для каждой части выражения, заключенного в теги.

Возвращаемое значение

Boolean

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 объектов, по одной для каждой части выражения с тегами.

Применяется к