Find2, interface

Article
05/16/2015

Prend en charge les opérations Find de texte dans l'environnement pour les documents et les fichiers.

Espace de noms : EnvDTE80
Assembly : EnvDTE80 (dans EnvDTE80.dll)

Syntaxe

'Déclaration
<GuidAttribute("01568308-5B2A-4F30-8D0A-E10EE0F28F4A")> _
Public Interface Find2 _
    Inherits Find

[GuidAttribute("01568308-5B2A-4F30-8D0A-E10EE0F28F4A")]
public interface Find2 : Find

[GuidAttribute(L"01568308-5B2A-4F30-8D0A-E10EE0F28F4A")]
public interface class Find2 : Find

[<GuidAttribute("01568308-5B2A-4F30-8D0A-E10EE0F28F4A")>]
type Find2 =  
    interface 
        interface Find 
    end

public interface Find2 extends Find

Le type Find2 expose les membres suivants.

Propriétés

	Nom	Description
	Action	Obtient ou définit la méthode de recherche, par exemple rechercher l'occurrence suivante, tout rechercher, remplacer et rechercher, etc.
	Backwards	Obtient ou définit une valeur indiquant si la recherche est effectuée vers l'arrière à partir de la position actuelle.
	DTE	Obtient l'objet d'extensibilité de niveau supérieur.
	FilesOfType	Obtient ou définit l'extension de fichier pour les fichiers à rechercher.
	FindWhat	Obtient ou définit le texte ou modèle à rechercher.
	KeepModifiedDocumentsOpen	Obtient ou définit une valeur indiquant si les documents modifiés restent ouverts ou non après une opération de remplacement.
	MatchCase	Obtient ou définit une valeur indiquant si la recherche respecte la casse.
	MatchInHiddenText	Obtient ou définit une valeur indiquant si le texte masqué est inclus dans la recherche.
	MatchWholeWord	Obtient ou définit une valeur indiquant si la recherche porte sur des mots entiers uniquement.
	Parent	Obtient l'objet parent immédiat d'un objet Find.
	PatternSyntax	Obtient ou définit la syntaxe utilisée pour spécifier le modèle de recherche.
	ReplaceWith	Obtient ou définit le texte de remplacement pour une opération de remplacement.
	ResultsLocation	Obtient ou définit l'emplacement où les résultats sont affichés pour une opération de recherche en bloc.
	SearchPath	Obtient ou définit une liste de répertoires à utiliser pour une opération Rechercher dans les fichiers.
	SearchSubfolders	Obtient ou définit une valeur indiquant si les sous-dossiers sont inclus dans une opération de recherche.
	Target	Obtient ou définit la cible de l'opération de recherche, par exemple tous les documents ouverts, les fichiers, le document actif, etc.
	WaitForFindToComplete	Obtient ou définit une valeur indiquant si un résultat de recherche est retourné avant de poursuivre l'exécution.

Début

Méthodes

	Nom	Description
	Execute	Exécute une recherche basée sur les options définies pour l'objet Find.
	FindReplace	Exécute une opération Rechercher ou Remplacer basée sur les arguments de la méthode, sans affecter les options définies pour l'objet Find.

Début

Notes

L'objet Find vous permet de rechercher et de remplacer du texte dans différents endroits de l'environnement qui prennent en charge ces opérations, par exemple l'éditeur de code.

Il sert principalement pour enregistrer des macros. Le mécanisme d'enregistrement de macros de l'éditeur utilise Find plutôt que TextSelection.FindPattern afin que vous puissiez découvrir la fonctionnalité de recherche globale. En outre, il est généralement plus utile que d'utiliser l'objet TextSelection pour des opérations telles que Rechercher dans les fichiers.

L'état de recherche global de l'environnement Visual Studio est partagé par tous ses outils et fournit des fonctionnalités de recherche. Par exemple, tous les éléments Visual Studio partagent l'historique des modèles de recherche utilisés lors d'une session et le sens (en avant ou en arrière) de l'opération Find suivante pour les documents ouverts. Les propriétés de l'objet Find interagissent avec et suivent l'état de recherche global. Lorsque vous définissez des propriétés sur l'objet Find, vous définissez également l'état de recherche global. Si les utilisateurs exécutent une opération Find via l'environnement, l'objet Find reflète le type de recherche qu'ils exécutent. Étant donné que le code d'automation s'exécute de façon synchrone avec le thread UI de l'environnement, vous n'avez pas à vous soucier de définir des propriétés et de demander à l'utilisateur d'exécuter une recherche avant que vous puissiez appeler le Execute.

La méthode Execute exécute une opération Find basée sur les paramètres de l'objet Find. Vous pouvez également passer les arguments à la méthode FindReplace pour effectuer une recherche sans affecter l'état de recherche global. Il est important pour les clients automation d'être capable d'effectuer une recherche sans affecter l'état de recherche global ou interférer avec le modèle utilisateur final de l'état de l'environnement.

Exemples

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

Voir aussi

Référence

EnvDTE80, espace de noms

Partager via