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 влияния не оказывает. |