IVsAddProjectItemDlg.AddProjectItemDlg(UInt32, Guid, IVsProject, UInt32, String, String, String, String, Int32) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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.