Interfaccia Find

Articolo
08/11/2011

Supporta operazioni generali Find di testo nei documenti e file dell'ambiente.

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 modalità di ricerca quali Trova successivo, Trova tutto, Sostituisci e così via.
	Backwards	Ottiene o imposta un valore che indica se la ricerca viene eseguita all'indietro a partire dalla posizione corrente.
	DTE	Ottiene l'oggetto estensibilità di primo livello.
	FilesOfType	Ottiene o imposta l'estensione dei file nei quali eseguire la ricerca.
	FindWhat	Ottiene o imposta il testo o il criterio da cercare.
	KeepModifiedDocumentsOpen	Ottiene o imposta un valore che indica se i documenti modificati restano aperti dopo un'operazione Replace.
	MatchCase	Ottiene o imposta un valore che indica se per la ricerca viene applicata 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 per la ricerca vengono considerate solo le parole intere.
	Parent	Ottiene l'oggetto padre immediato di un oggetto Find.
	PatternSyntax	Ottiene o imposta la sintassi utilizzata per specificare il criterio di ricerca.
	ReplaceWith	Ottiene o imposta il testo di sostituzione in un'operazione di sostituzione.
	ResultsLocation	Ottiene o imposta la posizione in cui vengono visualizzati i risultati di un'operazione di ricerca di massa.
	SearchPath	Ottiene o imposta un elenco di directory da utilizzare in un'operazione di ricerca nei file.
	SearchSubfolders	Ottiene o imposta un valore che indica se le sottocartelle sono incluse in un'operazione Search.
	Target	Ottiene o imposta la destinazione dell'operazione di ricerca, ad esempio tutti i documenti aperti, i file, il documento attivo e così via.

In alto

Metodi

	Nome	Descrizione
	Execute	Effettua una ricerca in base alle opzioni impostate per l'oggetto Find.
	FindReplace	Effettua un'operazione di ricerca o sostituzione basata sugli argomenti del metodo senza modificare le opzioni impostate per l'oggetto Find.

In alto

Note

L'oggetto Find consente di cercare e sostituire del testo contenuto in parti dell'ambiente che supportano tali operazioni, ad esempio l'editor di codice.

Viene utilizzato principalmente nella registrazione di macro. Nel meccanismo di registrazione delle macro dell'editor viene utilizzato Find invece di TextSelection.FindPattern per consentire di individuare la funzionalità di ricerca globale e perché in genere risulta più utile rispetto all'utilizzo dell'oggetto TextSelection per operazioni quali la ricerca all'interno di file.

L'ambiente Visual Studio dispone di uno stato globale di ricerca condiviso da tutti gli strumenti che forniscono funzionalità di ricerca. Ad esempio, tutti gli elementi di Visual Studio condividono la cronologia dei criteri di ricerca utilizzati nel corso di una sessione e le informazioni relative alla direzione di ricerca dell'operazione Find successiva. Le proprietà dell'oggetto Find interagiscono e tengono traccia dello stato di ricerca globale. Quando si impostano le proprietà sull'oggetto Find, si imposta anche lo stato di ricerca globale. Se gli utenti eseguono operazioni Find nell'ambiente, l'oggetto Find rifletterà i tipi di ricerche effettuati. Poiché il codice di automazione viene eseguito in modo sincrono rispetto al thread dell'interfaccia utente dell'ambiente, non è necessario impostare alcune delle proprietà e richiedere all'utente di eseguire una ricerca per poter chiamare il metodo Execute.

Il metodo Execute esegue un'operazione Find basata sulle impostazioni dell'oggetto Find. È anche possibile passare argomenti al metodo FindReplace per eseguire una ricerca senza influire sullo stato di ricerca globale. È importante che i client di automazione siano in grado di effettuare ricerche senza modificare lo stato globale e senza interferire con il modello dello stato dell'ambiente dell'utente finale.

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