Interfaccia Find

Articolo
10/30/2012

Supporta il testo generico Find operazioni nell'ambiente per i documenti e file.

Spazio dei nomi: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Sintassi

'Dichiarazione
<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

Il tipo Find espone i seguenti membri.

Proprietà

	Nome	Descrizione
	Action	Ottiene o imposta come trovare dopo, come corrispondenza di ricerca, trovare tutti, di sostituzione e della ricerca, e così via.
	Backwards	Ottiene o imposta un valore che indica se la ricerca viene eseguita di nuovo dalla posizione corrente.
	DTE	Ottiene l'oggetto estensibilità di primo livello.
	FilesOfType	Ottiene o imposta l'estensione di file per i file vengano cercate.
	FindWhat	Ottiene o determina il testo o il modello da cercare.
	KeepModifiedDocumentsOpen	Ottiene o imposta un valore che indica se nei documenti modificati rimangono aperti dopo un oggetto Replace operazione.
	MatchCase	Ottiene o imposta un valore che indica se la ricerca prevede la distinzione tra maiuscole e minuscole.
	MatchInHiddenText	Ottiene o imposta un valore che indica se il testo nascosto viene incluso nella ricerca.
	MatchWholeWord	Ottiene o imposta un valore che indica se la ricerca alle parole intere solo.
	Parent	Ottiene l'oggetto padre immediato di un oggetto Find oggetto.
	PatternSyntax	Ottiene o imposta la sintassi utilizzata per specificare il criterio di ricerca.
	ReplaceWith	Ottiene o imposta il testo di sostituzione per un'operazione di sostituzione.
	ResultsLocation	Ottiene o imposta la posizione in cui i risultati vengono visualizzati in un'operazione di ricerca di massa.
	SearchPath	Ottiene o imposta un elenco di directory da utilizzare per un'operazione di ritrovamento-in-file.
	SearchSubfolders	Ottiene o imposta un valore che indica se le sottocartelle incluse in un'istruzione Search operazione.
	Target	Ottiene o imposta il database di destinazione dell'operazione di ricerca, come tutti visualizzati i documenti, i file, il documento attivo, e così via.

In alto

Metodi

	Nome	Descrizione
	Execute	Esegue una ricerca in base alle opzioni impostate per Find oggetto.
	FindReplace	Esegue un'operazione di sostituzione o di ricerca basata sugli argomenti al metodo, senza influenzare le opzioni impostate per Find.

In alto

Note

Find l'oggetto consente di ricercare e sostituire testo in posizioni dell'ambiente che supportano tali operazioni, quali l'editor di codice.

È destinata principalmente per la macro scopo di registrazione.La macro utilizzi di registrazione del meccanismo dell'editor Find anziché TextSelection.FindPattern in modo da poter individuare la funzionalità globale di ricerca e poiché è più utile di utilizzo di TextSelection oggetto per tali operazioni quali i Ritrovamento-in-file.

Ambiente di Visual Studio dispone dello stato complessivo di ricerca condiviso tra tutti gli strumenti che fornisce le funzionalità di ricerca.Ad esempio, tutti Visual Studio gli elementi condividono la cronologia dei criteri di ricerca utilizzati durante la sessione e se il codice Find l'operazione per i documenti aperti deve essere avanti o indietro.Find le proprietà dell'oggetto interagiscono con e tenere traccia dello stato complessivo di ricerca.Quando si impostano le proprietà su Find oggetto, impostare inoltre lo stato complessivo di ricerca.Se gli utenti eseguono un oggetto Find operazione mediante l'ambiente, Find l'oggetto corrisponde al tipo di ricerca che hanno eseguito.Poiché il codice di automazione funziona in modo sincrono al thread UI dell'ambiente, non è necessario impostare alcune proprietà e fare eseguire una ricerca all'utente prima di poter chiamare Execute.

Execute il metodo esegue un oggetto Find operazione in base alle impostazioni di Find oggetto.È anche possibile passare argomenti a FindReplace metodo per eseguire una ricerca senza influire sullo stato complessivo di ricerca.Per i client di automazione è importante poter eseguire una ricerca senza influire sullo stato complessivo di ricerca o interferire con il modello dell'utente finale dello stato dell'ambiente.

Esempi

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

Vedere anche

Riferimenti

Spazio dei nomi EnvDTE

Condividi tramite