IVsProject2.AddItem(UInt32, VSADDITEMOPERATION, String, UInt32, String[], IntPtr, VSADDRESULT[]) Methode

Definition

Erstellt neue Elemente in einem Projekt, fügt einem Projekt vorhandene Dateien hinzu oder bewirkt, dass "Element hinzufügen"-Assistenten ausgeführt werden.

public:
 int AddItem(System::UInt32 itemidLoc, Microsoft::VisualStudio::Shell::Interop::VSADDITEMOPERATION dwAddItemOperation, System::String ^ pszItemName, System::UInt32 cFilesToOpen, cli::array <System::String ^> ^ rgpszFilesToOpen, IntPtr hwndDlgOwner, cli::array <Microsoft::VisualStudio::Shell::Interop::VSADDRESULT> ^ pResult);
public int AddItem (uint itemidLoc, Microsoft.VisualStudio.Shell.Interop.VSADDITEMOPERATION dwAddItemOperation, string pszItemName, uint cFilesToOpen, string[] rgpszFilesToOpen, IntPtr hwndDlgOwner, Microsoft.VisualStudio.Shell.Interop.VSADDRESULT[] pResult);
abstract member AddItem : uint32 * Microsoft.VisualStudio.Shell.Interop.VSADDITEMOPERATION * string * uint32 * string[] * nativeint * Microsoft.VisualStudio.Shell.Interop.VSADDRESULT[] -> int
Public Function AddItem (itemidLoc As UInteger, dwAddItemOperation As VSADDITEMOPERATION, pszItemName As String, cFilesToOpen As UInteger, rgpszFilesToOpen As String(), hwndDlgOwner As IntPtr, pResult As VSADDRESULT()) As Integer

Parameter

itemidLoc
UInt32

[in] Bezeichner des Containerordners für das Element, das hinzugefügt wird. Sollte VSITEMID_ROOT oder ein anderer gültiger Elementbezeichner sein. Weitere Informationen finden Sie unter der Enumeration VSITEMID. Beachten Sie, dass dieser Parameter derzeit ignoriert wird, da nur das Hinzufügen von Elementen als untergeordnete Elemente eines Projektknotens unterstützt wird. Projekte, die das Konzept der Ordner unterstützen, möchten die Elemente relativ zu hinzufügen itemidLoc .

dwAddItemOperation
VSADDITEMOPERATION

[in] Vorgang, der auf das neu erstellte Element angewendet wird. Kann nur dann VSADDITEMOP_OPENDIRECTORY sein, wenn VSADDITEM_ShowAddFolderButton an die Methode AddProjectItemDlg(UInt32, Guid, IVsProject, UInt32, String, String, String, String, Int32) übergeben wird. Weitere Informationen finden Sie unter der Enumeration VSADDITEMOPERATION.

pszItemName
String

[in] Name des hinzuzufügenden Elements.

cFilesToOpen
UInt32

in Anzahl der Elemente in rgpszFilesToOpen . Kann Null sein. Dieser Wert muss 1 sein, wenn den Wert dwAddItemOperation VSADDITEMOP_CLONEFILE oder VSADDITEMOP_OPENDIRECTORY. Wenn VSADDITEMOP_RUNWIZARD, muss sie 1 oder 2 sein.

rgpszFilesToOpen
String[]

[in, size_is(cFilesToOpen)] Array von Zeigern auf OLESTR-Dateinamen. Wenn dwAddItemOperation ist VSADDITEMOP_CLONEFILE oder VSADDITEMOP_OPENDIRECTORY, ist das erste Element ( rgpszFilesToOpen[0] ) im-Array der Name der zu klonenden Datei oder das zu öffnende Verzeichnis. Wenn dies der Fall ist VSADDITEMOP_RUNWIZARD , ist das erste Element ( rgpszFilesToOpen[0] ) der Name des Assistenten, der ausgeführt werden soll, und das zweite Element ( rgpszFilesToOpen[1] ) ist der Dateiname, den der Benutzer angegeben hat (identisch mit pszItemName ).

hwndDlgOwner
IntPtr

in Handle für das Dialogfeld Element hinzufügen.

pResult
VSADDRESULT[]

[out, retval] Zeiger auf die VSADDRESULT-Enumeration, die angibt, ob das Element dem Projekt erfolgreich hinzugefügt wurde.

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 IVsProject2::AddItem(  
   [in] VSITEMID itemidLoc,   
   [in] VSADDITEMOPERATION dwAddItemOperation,  
   [in] LPCOLESTR pszItemName,  
   [in] ULONG cFilesToOpen,  
   [in, size_is(cFilesToOpen)] LPCOLESTR rgpszFilesToOpen[],  
   [in] HWND hwndDlgOwner,  
   [out, retval] VSADDRESULT * pResult  
);  

Diese Methode wird im Dialogfeld Element hinzufügen verwendet. Die-Methode kann neue Elemente erstellen, vorhandene Dateien hinzufügen oder die Ausführung von Assistenten zum Hinzufügen von Elementen bewirken.

Diese Methode sollte nur im UI-Thread aufgerufen werden. andernfalls wird eine ausgelöst COMException .

Gilt für