ModelingEditorFactory.CreateEditorInstance Method

Creates a modeling editor.

Namespace:  Microsoft.VisualStudio.Modeling.Shell
Assembly:  Microsoft.VisualStudio.Modeling.Sdk.Shell.12.0 (in Microsoft.VisualStudio.Modeling.Sdk.Shell.12.0.dll)

Syntax

'Declaration
Public Function CreateEditorInstance ( _
    createFlags As UInteger, _
    fileName As String, _
    physicalView As String, _
    hierarchy As IVsHierarchy, _
    itemId As UInteger, _
    existingDocData As IntPtr, _
    <OutAttribute> ByRef docView As IntPtr, _
    <OutAttribute> ByRef docData As IntPtr, _
    <OutAttribute> ByRef editorCaption As String, _
    <OutAttribute> ByRef cmdUI As Guid, _
    <OutAttribute> ByRef createDocWinFlags As Integer _
) As Integer

public int CreateEditorInstance(
    uint createFlags,
    string fileName,
    string physicalView,
    IVsHierarchy hierarchy,
    uint itemId,
    IntPtr existingDocData,
    out IntPtr docView,
    out IntPtr docData,
    out string editorCaption,
    out Guid cmdUI,
    out int createDocWinFlags
)

public:
virtual int CreateEditorInstance(
    unsigned int createFlags, 
    String^ fileName, 
    String^ physicalView, 
    IVsHierarchy^ hierarchy, 
    unsigned int itemId, 
    IntPtr existingDocData, 
    [OutAttribute] IntPtr% docView, 
    [OutAttribute] IntPtr% docData, 
    [OutAttribute] String^% editorCaption, 
    [OutAttribute] Guid% cmdUI, 
    [OutAttribute] int% createDocWinFlags
) sealed

abstract CreateEditorInstance : 
        createFlags:uint32 * 
        fileName:string * 
        physicalView:string * 
        hierarchy:IVsHierarchy * 
        itemId:uint32 * 
        existingDocData:IntPtr * 
        docView:IntPtr byref * 
        docData:IntPtr byref * 
        editorCaption:string byref * 
        cmdUI:Guid byref * 
        createDocWinFlags:int byref -> int  
override CreateEditorInstance : 
        createFlags:uint32 * 
        fileName:string * 
        physicalView:string * 
        hierarchy:IVsHierarchy * 
        itemId:uint32 * 
        existingDocData:IntPtr * 
        docView:IntPtr byref * 
        docData:IntPtr byref * 
        editorCaption:string byref * 
        cmdUI:Guid byref * 
        createDocWinFlags:int byref -> int

public final function CreateEditorInstance(
    createFlags : uint, 
    fileName : String, 
    physicalView : String, 
    hierarchy : IVsHierarchy, 
    itemId : uint, 
    existingDocData : IntPtr, 
    docView : IntPtr, 
    docData : IntPtr, 
    editorCaption : String, 
    cmdUI : Guid, 
    createDocWinFlags : int
) : int

Parameters

• createFlags
  Type: System.UInt32

  The flags that define how the modeling editor is created.

• fileName
  Type: System.String

  The name of the document to open for editing.

• physicalView
  Type: System.String

  The name of the modeling editor view.

• hierarchy
  Type: Microsoft.VisualStudio.Shell.Interop.IVsHierarchy

  The IVsHierarchy for the project that contains the document.

• itemId
  Type: System.UInt32

  The ID of the document.

• existingDocData
  Type: System.IntPtr

  If the document is already open in Visual Studio, the document.

• docView
  Type: System.IntPtr%

  The view for the document.

• docData
  Type: System.IntPtr%

  The document.

• editorCaption
  Type: System.String%

  The caption for the modeling editor.

• cmdUI
  Type: System.Guid%

  The GUID that is assigned to the modeling editor.

• createDocWinFlags
  Type: System.Int32%

  The flags to pass to CreateDocumentWindow.

Return Value

Type: System.Int32
The modeling editor.

Implements

IVsEditorFactory.CreateEditorInstance(UInt32, String, String, IVsHierarchy, UInt32, IntPtr, IntPtr%, IntPtr%, String%, Guid%, Int32%)

Remarks

This method is part of IVsEditorFactory and is called by Visual Studio to create the modeling editor. ModelingEditorFactory calls CreateDocData and CreateDocView as necessary.

.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.

See Also

Reference

ModelingEditorFactory Class

Microsoft.VisualStudio.Modeling.Shell Namespace