Find – rozhraní

Článek
08/11/2011

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 atd.
	Backwards	Získá nebo nastaví hodnotu označující, zda probíhá vyhledávání zpětně od aktuální pozice.
	DTE	Načtení objektu nejvyšší úrovně rozšiřitelnosti.
	FilesOfType	Získá nebo nastaví přípony souborů, které mají být prohledány.
	FindWhat	Získá nebo nastaví text nebo vzorek nalézt.
	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 do hledání zahrnuty.
	MatchWholeWord	Získá nebo nastaví hodnotu označující, zda hledání odpovídá pouze celá slova.
	Parent	Bezprostřední nadřízený objekt dostane 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 hledání všechny otevřené dokumenty, soubory, aktivní dokument a tak dále.

Na začátek

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.

Na začátek

Poznámky

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

Je určen především pro účely záznamu makra. Mechanismus používá záznam makra v editoru 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 objektu operace jako hledání-v-soubory.

Prostředí Visual Studio má stav globální hledání, který je sdílen všechny nástroje poskytující možnosti vyhledávání. Například všechny Visual Studio prvky historie hledání vzorků použitých během relace sdílení a zda další Find operace 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 nastavování vlastností na Find objektu je také nastavit globální hledání státu. 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ího prostředí uživatelského rozhraní, není nutné nastavit některé vlastnosti a uživatelské vyhledávání, než budete volat Execute.

Execute Metoda provádí Find operace na základě nastavení Find objektu. Můžete také předat argumenty FindReplace metodu vyhledávání bez ovlivnění stavu globální hledání. Je důležité, aby klientům automatizace provádět hledání bez ovlivnění stavu globální hledání nebo zasahování koncového uživatele modelu 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é

Odkaz

EnvDTE – obor názvů

Sdílet prostřednictvím