Find – rozhraní

Článek
10/27/2012

Podporuje obecný text Find operací v prostředí pro dokumenty a soubory.

Obor názvů: EnvDTE
Sestavení: EnvDTE (v EnvDTE.dll)

Syntaxe

'Deklarace
<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 zveřejňuje následující členy.

Vlastnosti

	Název	Popis
	Action	Získá nebo nastaví, jak najít, například najít další shoda, najít všechny, nahradit a hledat a tak dále.
	Backwards	Získá nebo nastaví hodnotu označující, zda probíhá vyhledávání dozadu od aktuální pozice.
	DTE	Načtení objektu nejvyšší úrovně rozšiřitelnosti.
	FilesOfType	Získá nebo nastaví přípona souboru pro soubory, které mají být prohledány.
	FindWhat	Získá nebo nastaví text nebo vzorek najít.
	KeepModifiedDocumentsOpen	Získá nebo nastaví hodnotu označující, zda upravovat dokumenty zůstávají otevřené po Replace operace.
	MatchCase	Získá nebo nastaví hodnotu označující, zda je hledání velká a malá písmena.
	MatchInHiddenText	Získá nebo nastaví hodnotu označující, zda je skrytý text zahrnut do vyhledávání.
	MatchWholeWord	Získá nebo nastaví hodnotu označující, zda hledání odpovídá pouze celá slova.
	Parent	Získá bezprostřední nadřízený objekt Find objektu.
	PatternSyntax	Získá nebo nastaví Syntaxe použitá k určení vzoru hledání.
	ReplaceWith	Získá nebo nastaví náhradní text pro operaci nahrazení.
	ResultsLocation	Získá nebo nastaví umístění, kde jsou výsledky zobrazeny v hromadné operace hledání.
	SearchPath	Získá nebo nastaví seznam adresářů pro operace hledání v soubory.
	SearchSubfolders	Získá nebo nastaví hodnotu označující, zda jsou součástí podsložky Search operace.
	Target	Získá nebo nastaví cíl operace vyhledávání jako všechny otevřené dokumenty, soubory, aktivní dokument a tak dále.

Nahoru

Metody

	Název	Popis
	Execute	Provede na základě možnosti nastavené pro hledání Find objektu.
	FindReplace	Provádí operaci hledání a nahrazení argumenty metody, na základě, bez ovlivnění možností nastavit Find.

Nahoru

Poznámky

Find Objekt umožňuje hledání a nahrazení textu na místech životního prostředí, které podporují takové operace, jako je například editor kódu.

Je určena především pro účely záznamu makra.Makra v editoru záznam používá mechanismus Find namísto TextSelection.FindPattern tak, že zjistíte globální funkce Najít a obecně je užitečnější než použití TextSelection objekt pro operace jako najít v soubory.

Prostředí Visual Studio má stav globální hledání, který je sdílen na všechny nástroje poskytující možnosti vyhledávání.Například všechny Visual Studio prvky sdílet historii hledání vzorků použitých během relace a zda další Find operace pro otevřené dokumenty by měly být dopředu nebo dozadu.Find Vlastnosti objektu pracovat a sledovat stav globální hledání.Při nastavení vlastnosti na Find objekt také nastavit stav globální hledání.Pokud uživatelé provádět Find operace prostřednictvím životního prostředí Find objekt odráží druh hledání provedení.Protože kód pro automatizaci pracuje synchronně s podprocesem životní prostředí uživatelského rozhraní, není nutné nastavit některé vlastnosti a uživatelské vyhledávání, než budete moci volat Execute.

Execute Metoda provádí Find operace na základě nastavení Find objektu.Můžete také předat argumenty FindReplace metoda bez ovlivnění globální vyhledávání najít státu.Je důležité, aby klientům automatizace provádět hledání bez ovlivnění stavu globální hledání nebo zasahování modelu koncového uživatele o stavu životního prostředí.

Příklady

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

Viz také

Referenční dokumentace

EnvDTE – obor názvů

Sdílet prostřednictvím