Find2 Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Unterstützt allgemeine Text Suchvorgänge in der Umgebung für Dokumente und Dateien.
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
- Attribute
- Implementiert
Beispiele
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
Hinweise
Mit dem- Find Objekt können Sie Text an Orten der Umgebung suchen und ersetzen, die solche Vorgänge unterstützen, z. b. den Code-Editor.
Es ist hauptsächlich für die Erstellung von Makro Zwecken vorgesehen. Der Makro Aufzeichnungs Mechanismus des Editors verwendet Find anstelle von TextSelection.FindPattern , damit Sie die globale Suchfunktion ermitteln können. Außerdem ist es in der Regel nützlicher als die Verwendung des- TextSelection Objekts für Vorgänge wie Suchen in-Dateien.
Der globale Such Zustand der Visual Studio-Umgebung wird von allen zugehörigen Tools gemeinsam genutzt und bietet Suchfunktionen. Alle Visual Studio-Elemente geben z. b. den Verlauf der Suchmuster frei, die während einer Sitzung verwendet werden, und geben an, ob der nächste Find Vorgang für geöffnete Dokumente vorwärts oder rückwärts erfolgen soll. Die Find Eigenschaften des-Objekts interagieren mit und verfolgen den globalen Such Zustand. Wenn Sie Eigenschaften für das Find Objekt festlegen, legen Sie auch den globalen Such Zustand fest. Wenn Benutzer einen Find Vorgang durch die Umgebung ausführen, Find spiegelt das Objekt die Art der durchgeführten Suche wider. Da Automatisierungs Code synchron mit dem UI-Thread der Umgebung ausgeführt wird, müssen Sie sich keine Gedanken über das Festlegen einiger Eigenschaften machen, und der Benutzer muss eine Suche durchführen, bevor Sie aufrufen können Execute .
Die- Execute Methode führt einen- Find Vorgang auf der Grundlage der Einstellungen des- Find Objekts aus. Sie können auch Argumente an die- FindReplace Methode übergeben, um eine Suche durchzuführen, ohne den globalen Such Zustand zu beeinflussen. Es ist wichtig, dass Automatisierungs Clients in der Lage sind, eine Suche durchzuführen, ohne den globalen Such Zustand zu beeinträchtigen oder das Modell des Endbenutzers auf den Zustand der Umgebung zu beeinträchtigen.
Eigenschaften
| Action |
Ruft ab oder legt fest, wie gesucht werden soll, z. B. nächste Übereinstimmung suchen, alle suchen, suchen und ersetzen usw. |
| Backwards |
Ruft einen Wert ab, der angibt, ob die Suche rückwärts ab der aktuellen Position durchgeführt wird, oder legt diesen fest. |
| DTE |
Ruft das Erweiterbarkeitsobjekt der obersten Ebene ab. |
| FilesOfType |
Ruft die Dateierweiterung für die zu suchenden Dateien ab oder legt diese fest. |
| FindWhat |
Ruft den zu suchenden Text bzw. das zu suchende Muster ab oder legt diese fest. |
| KeepModifiedDocumentsOpen |
Ruft einen Wert ab, der angibt, ob geänderte Dokumente nach einer Ersetzung geöffnet bleiben, oder legt diesen fest. |
| MatchCase |
Ruft einen Wert ab, der angibt, ob bei der Suche die Groß-/Kleinschreibung beachtet wird, oder legt diesen fest. |
| MatchInHiddenText |
Ruft einen Wert ab, der angibt, ob ausgeblendeter Text in die Suche einbezogen wird, oder legt diesen fest. |
| MatchWholeWord |
Ruft einen Wert ab, der angibt, ob bei der Suche nur ganze Wörter beachtet werden, oder legt diesen fest. |
| Parent |
Ruft das unmittelbar übergeordnete Objekt eines Find-Objekts ab. |
| PatternSyntax |
Ruft die Syntax ab, mit der das Suchmuster angegeben wurde, oder legt diese fest. |
| ReplaceWith |
Ruft den Ersetzungstext für einen Ersetzungsvorgang ab oder legt diesen fest. |
| ResultsLocation |
Ruft den Ort ab, an dem die Ergebnisse bei einem Massen-Suchvorgang angezeigt werden, oder legt ihn fest. |
| SearchPath |
Ruft eine Liste von Verzeichnissen ab, die für eine Dateisuche in Verzeichnissen verwendet werden sollen, oder legt diese fest. |
| SearchSubfolders |
Ruft einen Wert ab, der angibt, ob Unterordner bei einem Suchvorgang beachtet werden, oder legt diesen fest. |
| Target |
Ruft das Ziel des Suchvorgangs ab, z. B. alle geöffneten Dokumente, Dateien, aktives Dokument usw., bzw. legt das Ziel fest. |
| WaitForFindToComplete |
Ruft einen Wert ab, der angibt, ob Suchergebnisse zurückgegeben werden, bevor die Suche fortgesetzt wird, oder legt diesen fest. |
Methoden
| Execute() |
Führt eine Suche basierend auf den für das Find-Objekt gesetzten Optionen durch. |
| FindReplace(vsFindAction, String, Int32, String, vsFindTarget, String, String, vsFindResultsLocation) |
Führt einen Suchen-und-Ersetzen-Vorgang basierend auf den Argumenten der Methode durch. Dies wirkt sich nicht auf die für das Find-Objekt gesetzten Optionen aus. |