IVsProject3::AddItemWithSpecific Method (UInt32, VSADDITEMOPERATION, String^, UInt32, array<String^>^, IntPtr, UInt32, Guid, String^, Guid, array<VSADDRESULT>^)

Visual Studio 2015

Adds an item using a specific editor.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (in Microsoft.VisualStudio.Shell.Interop.dll)

Syntax

C++

int AddItemWithSpecific(
	unsigned int itemidLoc,
	VSADDITEMOPERATION dwAddItemOperation,
	String^ pszItemName,
	unsigned int cFilesToOpen,
	array<String^>^ rgpszFilesToOpen,
	IntPtr hwndDlgOwner,
	unsigned int grfEditorFlags,
	[InAttribute] Guid% rguidEditorType,
	String^ pszPhysicalView,
	[InAttribute] Guid% rguidLogicalView,
	array<VSADDRESULT>^ pResult
)

Parameters

itemidLoc: Type: System::UInt32
[in] Item identifier of the item to add. Values are taken from the VSITEMID DWORD.

dwAddItemOperation: Type: Microsoft.VisualStudio.Shell.Interop::VSADDITEMOPERATION
[in] Values taken from the VSADDITEMOPERATION enumeration.

pszItemName: Type: System::String^
[in] Name of the item to be added.

cFilesToOpen: Type: System::UInt32
[in] Number of files to open.

rgpszFilesToOpen: Type: array<System::String^>^
[in, size_is(cFilesToOpen)] Actual number of files passed in with cFilesToOpen.

hwndDlgOwner: Type: System::IntPtr
[in] Handle to the dialog box.

grfEditorFlags: Type: System::UInt32
[in] Flags whose values are taken from the __VSSPECIFICEDITORFLAGS enumeration.

rguidEditorType: Type: System::Guid
[in] Unique identifier of the editor type.

pszPhysicalView: Type: System::String^
[in] Name of physical view.

rguidLogicalView: Type: System::Guid
[in] Name of the logical view.

pResult: Type: array<Microsoft.VisualStudio.Shell.Interop::VSADDRESULT>^
[out, retval] Results whose values are taken from the VSADDRESULT enumeration.

Return Value

Type: System::Int32

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From vsshell.idl:

C++

HRESULT IVsProject3::AddItemWithSpecific(
   [in] VSITEMID itemidLoc,
   [in] VSADDITEMOPERATION dwAddItemOperation,
   [in] LPCOLESTR pszItemName,
   [in] ULONG cFilesToOpen,
   [in, size_is(cFilesToOpen)] LPCOLESTR rgpszFilesToOpen[],
   [in] HWND hwndDlgOwner,
   [in] VSSPECIFICEDITORFLAGS grfEditorFlags,
   [in] REFGUID rguidEditorType,
   [in] LPCOLESTR pszPhysicalView,
   [in] REFGUID rguidLogicalView,
   [out, retval] VSADDRESULT *pResult
);

This method is used to add item(s) to the project and additionally to ask the project to open the item using the specified editor information. It is an extension of AddItem.

Implemented in conjunction with OpenSpecificEditor.