Find2 Интерфейс

Определение

Поддерживает общие операции поиска текста в среде для документов и файлов.

public interface class Find2 : EnvDTE::Find
public interface class Find2 : EnvDTE::Find
__interface Find2 : EnvDTE::Find
[System.Runtime.InteropServices.Guid("01568308-5B2A-4F30-8D0A-E10EE0F28F4A")]
[System.Runtime.InteropServices.TypeLibType(4160)]
public interface Find2 : EnvDTE.Find
[<System.Runtime.InteropServices.Guid("01568308-5B2A-4F30-8D0A-E10EE0F28F4A")>]
[<System.Runtime.InteropServices.TypeLibType(4160)>]
type Find2 = interface
    interface Find
Public Interface Find2
Implements Find
Атрибуты
Реализации

Примеры

Sub FindExample()  
   Dim objTextDoc As TextDocument  
   Dim objEditPt As EditPoint  
   Dim iCtr As Integer  
   Dim objFind As Find  

   ' 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  
   objFind = objTextDoc.DTE.Find  

   ' Insert ten lines of text.  
   For iCtr = 1 To 10  
      objEditPt.Insert("This is a test." & Chr(13))  
   Next iCtr  

   ' Set the find options.  
   objFind.Action = vsFindAction.vsFindActionReplaceAll  
   objFind.Backwards = False  
   objFind.FilesOfType = "*.txt"  
   objFind.FindWhat = "test"  
   objFind.KeepModifiedDocumentsOpen = True  
   objFind.MatchCase = False  
   objFind.MatchInHiddenText = False  
   objFind.MatchWholeWord = True  
   objFind.PatternSyntax = vsFindPatternSyntax.vsFindPatternSyntaxLiteral  
   objFind.ReplaceWith = "NEW THING"  
   objFind.ResultsLocation = vsFindResultsLocation.vsFindResultsNone  
   objFind.SearchPath = "c:\temp"  
   objFind.SearchSubfolders = False  
   objFind.Target = vsFindTarget.vsFindTargetCurrentDocument  
   ' Perform the Find operation.  
   objFind.Execute()  
End Sub  

Комментарии

FindОбъект позволяет находить и заменять текст в местах среды, которые поддерживают такие операции, как редактор кода.

Она предназначена в первую очередь для записи макросов. Механизм записи макросов редактора использует Find вместо того TextSelection.FindPattern , чтобы можно было обнаружить функциональность глобального поиска. Более того, обычно это более полезно, чем использование TextSelection объекта для таких операций, как поиск в файлах.

Глобальное состояние поиска в среде Visual Studio является общим для всех инструментов и предоставляет возможности поиска. Например, все элементы Visual Studio совместно используют журнал шаблонов поиска, используемых во время сеанса, и должна ли следующая Find операция для открытых документов передаваться или в обратном направлении. FindСвойства объекта взаимодействуют с и отслеживанием глобального состояния поиска. При задании свойств Find объекта также устанавливается глобальное состояние поиска. Если пользователи выполняют Find операцию в среде, Find объект отражает тип выполняемого поиска. Так как код автоматизации выполняется синхронно с потоком пользовательского интерфейса среды, не нужно беспокоиться о настройке некоторых свойств и о том, что пользователь должен выполнить поиск перед вызовом метода Execute .

ExecuteМетод выполняет Find операцию на основе параметров Find объекта. Можно также передать аргументы в FindReplace метод для выполнения поиска без влияния на глобальное состояние поиска. Важно, чтобы клиенты службы автоматизации могли выполнять поиск, не влияя на глобальное состояние поиска или не мешая модели состояния среды конечного пользователя.

Свойства

Action

Возвращает или задает способы поиска (найти далее, соблюдать регистр, найти все, заменить и найти и т. д.).

Backwards

Указывает, осуществляется ли поиск по документу в обратном направлении от текущей позиции, или получает информацию об этом.

DTE

Возвращает объект расширения верхнего уровня.

FilesOfType

Задает или получает расширение файлов, в которых осуществляется поиск.

FindWhat

Возвращает или задает искомый текст или шаблон.

KeepModifiedDocumentsOpen

Получает или задает значение, указывающее, остаются ли измененные документы открытыми после операции замены.

MatchCase

Возвращает или задает значение, указывающее, учитывается ли при поиске регистр.

MatchInHiddenText

Возвращает или задает значение, указывающее, включается ли в поиск скрытый текст.

MatchWholeWord

Возвращает или задает значение, указывающее, производится ли поиск только по точным совпадениям слов.

Parent

Возвращает ближайший родительский объект для объекта Find.

PatternSyntax

Задает или возвращает синтаксис, который используется при указании шаблона поиска.

ReplaceWith

Возвращает или задает текст, на который осуществляется замещение при выполнении операции замещения.

ResultsLocation

Возвращает или задает место отображения результатов во время операции массового поиска.

SearchPath

Возвращает или задает список каталогов, которые будут использоваться при выполнении операции поиска в файлах.

SearchSubfolders

Получает или задает значение, указывающее, будут ли при операции поиска включаться в поиск вложенные папки.

Target

Возвращает или задает целевой объект операции поиска, например все открытые документы, файлы, активный документ и т. д.

WaitForFindToComplete

Возвращает или задает значение, указывающее, возвращаются ли результаты поиска до того, как продолжить выполнение.

Методы

Execute()

Выполняет поиск на основе параметров, заданных для объекта Find.

FindReplace(vsFindAction, String, Int32, String, vsFindTarget, String, String, vsFindResultsLocation)

Выполняет операции поиска или замены на основе аргументов метода. На параметры Find влияния не оказывает.

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