IVsProject3.OpenItemWithSpecific Method

Article
03/06/2013

Opens an item using a specific editor.

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

Syntax

'Declaration
Function OpenItemWithSpecific ( _
    itemid As UInteger, _
    grfEditorFlags As UInteger, _
    ByRef rguidEditorType As Guid, _
    pszPhysicalView As String, _
    ByRef rguidLogicalView As Guid, _
    punkDocDataExisting As IntPtr, _
    <OutAttribute> ByRef ppWindowFrame As IVsWindowFrame _
) As Integer

int OpenItemWithSpecific(
    uint itemid,
    uint grfEditorFlags,
    ref Guid rguidEditorType,
    string pszPhysicalView,
    ref Guid rguidLogicalView,
    IntPtr punkDocDataExisting,
    out IVsWindowFrame ppWindowFrame
)

int OpenItemWithSpecific(
    [InAttribute] unsigned int itemid, 
    [InAttribute] unsigned int grfEditorFlags, 
    [InAttribute] Guid% rguidEditorType, 
    [InAttribute] String^ pszPhysicalView, 
    [InAttribute] Guid% rguidLogicalView, 
    [InAttribute] IntPtr punkDocDataExisting, 
    [OutAttribute] IVsWindowFrame^% ppWindowFrame
)

abstract OpenItemWithSpecific : 
        itemid:uint32 * 
        grfEditorFlags:uint32 * 
        rguidEditorType:Guid byref * 
        pszPhysicalView:string * 
        rguidLogicalView:Guid byref * 
        punkDocDataExisting:IntPtr * 
        ppWindowFrame:IVsWindowFrame byref -> int

function OpenItemWithSpecific(
    itemid : uint, 
    grfEditorFlags : uint, 
    rguidEditorType : Guid, 
    pszPhysicalView : String, 
    rguidLogicalView : Guid, 
    punkDocDataExisting : IntPtr, 
    ppWindowFrame : IVsWindowFrame
) : int

Parameters

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

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 the physical view.

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

punkDocDataExisting
Type: System.IntPtr
[in] Pointer to the IUnknown interface on the document to open.

ppWindowFrame
Type: Microsoft.VisualStudio.Shell.Interop.IVsWindowFrame%
[out] Pointer to the IVsWindowFrame2 interface.

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:

HRESULT IVsProject3::OpenItemWithSpecific(
   [in] VSITEMID itemid,
   [in] VSSPECIFICEDITORFLAGS grfEditorFlags,
   [in] REFGUID rguidEditorType,
   [in] LPCOLESTR pszPhysicalView,
   [in] REFGUID rguidLogicalView,
   [in] IUnknown *punkDocDataExisting,
   [out] IVsWindowFrame **ppWindowFrame
);

This method is used to ask the project to open the item (document) using the specified editor information. It is an extension of OpenItem.

It is implemented in conjunction with OpenSpecificEditor.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.