IVsAddProjectItemDlg.AddProjectItemDlg(UInt32, Guid, IVsProject, UInt32, String, String, String, String, Int32) Méthode

Définition

Affiche la boîte de dialogue Ajouter un élément pour le compte du projet appelant.

public:
 int AddProjectItemDlg(System::UInt32 itemidLoc, Guid % rguidProject, Microsoft::VisualStudio::Shell::Interop::IVsProject ^ pProject, System::UInt32 grfAddFlags, System::String ^ lpszExpand, System::String ^ lpszSelect, [Runtime::InteropServices::Out] System::String ^ % pbstrLocation, [Runtime::InteropServices::Out] System::String ^ % pbstrFilter, [Runtime::InteropServices::Out] int % pfDontShowAgain);
public int AddProjectItemDlg (uint itemidLoc, ref Guid rguidProject, Microsoft.VisualStudio.Shell.Interop.IVsProject pProject, uint grfAddFlags, string lpszExpand, string lpszSelect, out string pbstrLocation, out string pbstrFilter, out int pfDontShowAgain);
abstract member AddProjectItemDlg : uint32 * Guid * Microsoft.VisualStudio.Shell.Interop.IVsProject * uint32 * string * string * string * string * int -> int
Public Function AddProjectItemDlg (itemidLoc As UInteger, ByRef rguidProject As Guid, pProject As IVsProject, grfAddFlags As UInteger, lpszExpand As String, lpszSelect As String, ByRef pbstrLocation As String, ByRef pbstrFilter As String, ByRef pfDontShowAgain As Integer) As Integer

Paramètres

itemidLoc
UInt32

[in] Identificateur d'élément du dossier du projet auquel les éléments doivent être ajoutés. Utile uniquement pour les projets basés sur des répertoires. Les projets non basés sur les répertoires passent la VSITEMID_ROOT. La boîte de dialogue Ajouter un élément n’utilise pas le paramètre, sauf pour le repasser à la AddItemWithSpecific(UInt32, VSADDITEMOPERATION, String, UInt32, String[], IntPtr, UInt32, Guid, String, Guid, VSADDRESULT[]) méthode.

rguidProject
Guid

[in] Identificateur du type de projet. Inscrit ce paramètre sous la sous-clé Projets de la clé de Registre de Microsoft Visual Studio. La boîte de dialogue utilise les informations suivantes sous cette clé : la valeur ItemTemplateDir, qui contient le chemin d’accès au répertoire contenant les modèles d’élément pour ce type de projet. Clé de filtres utilisée pour construire des filtres ouverts pour l’onglet existant. Éléments et filtres spécifiques à ce type de projet, qui sont affichés dans la boîte de dialogue.

pProject
IVsProject

[in] Pointeur vers l'interface IVsProject spécifique que la boîte de dialogue utilise pour générer les noms par défaut de chaque élément en appelant la méthode GenerateUniqueItemName(UInt32, String, String, String) de l'interface, et provoquer l'ajout d'éléments au projet en appelant la méthode AddItem(IDataObject, TBXITEMINFO[], String).

grfAddFlags
UInt32

[in] Valeurs d'indicateur issues de l'énumération __VSADDITEMFLAGS qui modifient le comportement de la boîte de dialogue.

lpszExpand
String

[in] Sous-dossier du répertoire de modèle d'élément à sélectionner et à développer, s'il contient des sous-dossiers propres. Ce paramètre lance simplement l'état de l'arborescence et n'affecte pas le répertoire de modèle d'élément.

lpszSelect
String

dans Élément dans le pszExpand dossier à sélectionner. Le projet utilise ce paramètre pour implémenter un pense-bête pour l'élément sélectionné. Ce paramètre remplace le comportement par défaut de la boîte de dialogue, qui consiste à sélectionner le premier élément dans le dossier.

pbstrLocation
String

[in, out] Pointeur vers le champ d'emplacement (valeur initiale/finale). Ce paramètre est utilisé uniquement si vous spécifiez VSADDITEM_ShowLocationField. Pour spécifier un pense-bête pour le champ d'emplacement, qui est le comportement recommandé, souvenez-vous de la dernière valeur du champ d'emplacement et repassez-la lorsque vous ouvrez à nouveau la boîte de dialogue.

pbstrFilter
String

[in, out] Initialise et retourne la valeur finale de la chaîne de filtre (sous l’onglet existant). Spécifiez VSADDITEM_AllowStickyFilter pour retourner une valeur pour la chaîne de filtre. Pour spécifier un pense-bête pour le champ de filtre, qui est le comportement recommandé, souvenez-vous de la dernière valeur du champ de filtre et repassez-la lorsque vous ouvrez à nouveau la boîte de dialogue.

pfDontShowAgain
Int32

à Détermine si l’utilisateur a activé ou désactivé l’option ne plus afficher cette boîte de dialogue. Ce paramètre est utilisé uniquement si vous spécifiez VSADDITEM_ShowDontShowAgain. Pour implémenter l'option, qui est le comportement recommandé, appelez directement la méthode AddItem(UInt32, VSADDITEMOPERATION, String, UInt32, String[], IntPtr, VSADDRESULT[]) propre au dernier modèle d'élément sélectionné. En général, un projet gère une option Ne plus afficher séparée pour chaque type d'élément, tel qu'un élément de formulaire, de module et de classe.

Retours

Int32

Si la méthode réussit, retourne S_OK. En cas d'échec, retourne un code d'erreur.

Remarques

Signature COM

À partir de vsshell80. idl :

HRESULT IVsAddProjectItemDlg::AddProjectItemDlg(  
   [in] VSITEMID itemidLoc,   
   [in] REFGUID rguidProject,   
   [in] IVsProject *pProject,   
   [in] VSADDITEMFLAGS grfAddFlags,   
   [in] LPCOLESTR lpszExpand,   
   [in] LPCOLESTR lpszSelect,   
   [in, out] BSTR *pbstrLocation,   
   [in, out] BSTR *pbstrFilter,   
   [out] BOOL *pfDontShowAgain  
);  

L’appelant doit implémenter IVsProject pour utiliser cette méthode. La boîte de dialogue n’est qu’un mécanisme de sélection. L’appelant doit effectuer les tâches nécessaires pour ajouter un élément à un projet et l’ouvrir dans un éditeur. La boîte de dialogue appelle la AddItem méthode pour ajouter un fichier ou un modèle sélectionné ou un assistant au projet.

S’applique à