Udostępnij za pośrednictwem


Interfejs Find

Obsługuje ogólne tekst Find operacji w środowisku dokumentów i plików.

Przestrzeń nazw:  EnvDTE
Zestaw:  EnvDTE (w EnvDTE.dll)

Składnia

'Deklaracja
<GuidAttribute("40D4B9B6-739B-4965-8D65-692AEC692266")> _
Public Interface Find
[GuidAttribute("40D4B9B6-739B-4965-8D65-692AEC692266")]
public interface Find
[GuidAttribute(L"40D4B9B6-739B-4965-8D65-692AEC692266")]
public interface class Find
[<GuidAttribute("40D4B9B6-739B-4965-8D65-692AEC692266")>]
type Find =  interface end
public interface Find

Typ Find uwidacznia następujące elementy członkowskie.

Właściwości

  Nazwa Opis
Właściwość publiczna Action Zwraca lub ustawia sposób znajdowania, takie jak znaleźć następnego dopasowania, Znajdź wszystkie, zamienianie i Znajdź i itd.
Właściwość publiczna Backwards Pobiera lub ustawia wartość określającą, czy wyszukiwanie jest wykonywane wstecz od bieżącej pozycji.
Właściwość publiczna DTE Pobiera obiekt rozszerzalności najwyższego poziomu.
Właściwość publiczna FilesOfType Zwraca lub ustawia rozszerzenie pliku dla plików, które mają być przeszukiwane.
Właściwość publiczna FindWhat Pobiera lub ustawia tekst lub deseń, aby znaleźć.
Właściwość publiczna KeepModifiedDocumentsOpen Pobiera lub ustawia wartość określającą zmodyfikowane lub nie, dokumenty pozostaną otwarte po Replace operacji.
Właściwość publiczna MatchCase Pobiera lub ustawia wartość określającą, czy przeszukiwanie jest wielkość liter.
Właściwość publiczna MatchInHiddenText Pobiera lub ustawia wartość określającą, czy tekst ukryty jest uwzględnione w wyszukiwaniu.
Właściwość publiczna MatchWholeWord Pobiera lub ustawia wartość określającą, czy wyszukiwanie dopasowuje tylko całe wyrazy.
Właściwość publiczna Parent Zwraca obiekt nadrzędny natychmiastowe z Find obiektu.
Właściwość publiczna PatternSyntax Zwraca lub ustawia Składnia używana do określania wzorców szukania.
Właściwość publiczna ReplaceWith Zwraca lub ustawia tekst zastępczy dla operacja zastępowania.
Właściwość publiczna ResultsLocation Zwraca lub ustawia lokalizację, gdzie wyniki zostaną wyświetlone w zbiorczej operacji wyszukiwania.
Właściwość publiczna SearchPath Zwraca lub ustawia listę katalogów do użytku w operacji Znajdź pliki.
Właściwość publiczna SearchSubfolders Zwraca lub ustawia wartość określającą, czy podfoldery mają być uwzględniane w Search operacji.
Właściwość publiczna Target Zwraca lub ustawia obiekt docelowy operacji wyszukiwania, takie jak wszystkie otwarte dokumenty, pliki, aktywnego dokumentu i tak dalej.

Początek

Metody

  Nazwa Opis
Metoda publiczna Execute Wykonuje wyszukiwanie oparte na opcje ustawione dla Find obiektu.
Metoda publiczna FindReplace Wykonuje operację Znajdź lub wymiany, na podstawie argumentów do metody, bez wpływu na opcje ustawione dla Find.

Początek

Uwagi

Find Obiektu pozwala wyszukiwać i zastępować tekst w miejscach środowiska, które obsługują takie operacje, takie jak edytor kodu.

Jest on przeznaczony głównie do celów rejestrowania makra.Edytor makr nagrywanie używa mechanizmu Find zamiast TextSelection.FindPattern , dzięki czemu można odkryć globalny funkcje Znajdź i zazwyczaj jest bardziej użyteczna niż przy użyciu TextSelection obiektu dla takich operacji jak Znajdź pliki.

Środowiska Visual Studio ma globalnego Znajdź stan który jest współużytkowana przez wszystkie jej narzędzi, który zapewnia możliwości wyszukiwania.Na przykład wszystkie Visual Studio elementy udział historii wzorce wyszukiwania używane podczas sesji i czy następnego Find operacji dla otwartych dokumentów należy do przodu lub do tyłu.Find Właściwości obiektu interakcja i śledzić stan globalny Znajdź.Podczas ustawiania właściwości na Find obiektów, można również ustawić stan globalny Znajdź.Jeśli użytkownicy będą wykonywać Find operacji poprzez środowisko naturalne, Find obiektu odzwierciedla rodzaj wyszukiwania one wykonywane.Ponieważ kod automatyzacji jest uruchamiana synchronicznie z wątku interfejsu użytkownika środowiska, nie trzeba ustawić niektóre właściwości i użytkownik wyszukiwania przed wywołaniem Execute.

Execute Wykonuje się metodą Find operacji na podstawie ustawień z Find obiektu.Można również przekazywać argumenty do FindReplace metody do wyszukiwania, bez wpływu na globalne znaleźć Państwo.Jest ważne dla klientów automatyzacji móc przeprowadzić wyszukiwanie bez wpływu na stan globalny Znajdź lub zakłócać modelu użytkownika końcowego środowiska Państwa.

Przykłady

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

Zobacz też

Informacje

Przestrzeń nazw EnvDTE