Find2 Schnittstelle

Definition

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.

Gilt für