IVsAddProjectItemDlg2.AddProjectItemDlg(UInt32, Guid, IVsProject, UInt32, String, String, String, String, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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.