Interfaccia Find
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