IVsAddProjectItemDlg2.AddProjectItemDlg(UInt32, Guid, IVsProject, UInt32, String, String, String, String, Int32) Methode

Definition

Zeigt das Dialogfeld "Element hinzufügen" im Namen des aufrufenden Projekts an.

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

Parameter

itemidLoc
UInt32

[in] Elementbezeichner des Ordners im Projekt, in dem Elemente hinzugefügt werden sollen. Dies ist nur für verzeichnisbasierte Projekte sinnvoll. Nicht-Verzeichnis-basierte Projekte übergeben VSITEMID_ROOT. Im Dialogfeld Element hinzufügen wird der-Parameter nicht verwendet, es sei denn, es wird an die-Methode zurückgegeben AddItemWithSpecific(UInt32, VSADDITEMOPERATION, String, UInt32, String[], IntPtr, UInt32, Guid, String, Guid, VSADDRESULT[]) .

rguidProject
Guid

[in] Bezeichner für den Projekttyp. Registrieren diesen Parameter unter dem Projektunterschlüssel des Microsoft Visual Studio-Registrierungsschlüssels. Im Dialogfeld werden unter diesem Schlüssel die folgenden Informationen verwendet: der itemtemplatedir-Wert, der den Pfad zu dem Verzeichnis enthält, das Element Vorlagen für diesen Projekttyp enthält. Die Filters-Taste, die verwendet wird, um offene Filter für die vorhandene Registerkarte zu erstellen. Für diesen Projekttyp spezifische Elemente und Filter, die im Dialogfeld angezeigt werden.

pProject
IVsProject

[in] Zeiger auf bestimmte IVsProject-Schnittstelle, die das Dialogfeld zur Erstellung von Standardnamen für jedes Element durch Aufruf der GenerateUniqueItemName(UInt32, String, String, String)-Methode der Schnittstelle verwendet und um Elemente dem Projekt durch Aufruf der AddItem(UInt32, VSADDITEMOPERATION, String, UInt32, String[], IntPtr, VSADDRESULT[])-Methode hinzuzufügen.

grfAddFlags
UInt32

[in] Flagwerte aus der __VSADDITEMFLAGS-Enumeration, die das Verhalten des Dialogfelds ändern.

lpszExpand
String

[in] Unterordner des Elementvorlagenverzeichnisses, das ausgewählt und erweitert werden soll, wenn es eigene Unterordner besitzt. Dieser Parameter initialisiert lediglich den Zustand der Struktur und beeinflusst nicht, welches das Elementvorlagenverzeichnis ist.

lpszSelect
String

in Das Element innerhalb des pszExpand Ordners, das ausgewählt werden soll. Das Projekt verwendet diesen Parameter, um ein Haftverhalten für das ausgewählte Element zu implementieren. Dieser Parameter überschreibt das Standardverhalten für das Dialogfeld, womit der erste Punkt im Ordner ausgewählt wird.

pbstrLocation
String

[in, out] Zeiger auf das Speicherortfeld (ursprünglicher/endgültiger Wert). Dieser Parameter wird nur verwendet, wenn VSADDITEM_ShowLocationField angegeben wird. Um ein Haftverhalten für den Speicherort festzulegen, was das empfohlene Verhalten ist, merken Sie sich den letzten Speicherortwert und geben Sie ihn zurück, wenn Sie das Dialogfeld erneut öffnen.

pbstrFilter
String

[in, out] Initialisiert den endgültigen Wert der Filter Zeichenfolge (auf der vorhandenen Registerkarte) und gibt ihn zurück. Bezeichne VSADDITEM_AllowStickyFilter, um einen Wert für die Filterzeichenfolge zurückzugeben. Um ein Haftverhalten für das Filterfeld festzulegen, was das empfohlene Verhalten ist, merken Sie sich den letzten Filterfeldwert und geben Sie ihn zurück, wenn Sie das Dialogfeld erneut öffnen.

pfDontShowAgain
Int32

vorgenommen Bestimmt, ob der Benutzer die Option dieses Dialogfeld nicht mehr anzeigen aktiviert oder deaktiviert hat. Dieser Parameter wird nur verwendet, wenn VSADDITEM_ShowDontShowAgain angegeben wird. Um die Option zu implementieren, was das empfohlene Verhalten ist, rufen Sie direkt die zuletzt ausgewählte eigene AddItem(UInt32, VSADDITEMOPERATION, String, UInt32, String[], IntPtr, VSADDRESULT[])-Methode der Elementvorlage auf. In der Regel behält ein Projekt eine separate "DontShowAgain"-Option für jeden Elementtyp, wie Formular, Modul und Klasse.

Gibt zurück

Int32

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Implementiert

Hinweise

COM-Signatur

Aus vsshell. idl:

HRESULT IVsAddProjectItemDlg2::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  
);  

Der Aufrufer muss implementieren IVsProject , um diese Methode zu verwenden. Das Dialogfeld ist nur ein Auswahlmechanismus. Der Aufrufer muss die erforderlichen Aufgaben zum Hinzufügen eines Elements zu einem Projekt ausführen und in einem Editor öffnen. Im Dialogfeld wird die- AddItem Methode aufgerufen, um dem Projekt eine ausgewählte Datei oder Vorlage oder einen Assistenten hinzuzufügen.

Gilt für