EditorFactory.CreateEditorInstance 方法

用于创建 Visual Studio 核心编辑器,支持数据/视图分开的编辑器。

命名空间:  Microsoft.VisualStudio.Package
程序集:   Microsoft.VisualStudio.Package.LanguageService(在 Microsoft.VisualStudio.Package.LanguageService.dll 中)
  Microsoft.VisualStudio.Package.LanguageService.9.0(在 Microsoft.VisualStudio.Package.LanguageService.9.0.dll 中)
  Microsoft.VisualStudio.Package.LanguageService.11.0(在 Microsoft.VisualStudio.Package.LanguageService.11.0.dll 中)
  Microsoft.VisualStudio.Package.LanguageService.10.0(在 Microsoft.VisualStudio.Package.LanguageService.10.0.dll 中)

语法

声明
Public Overridable Function CreateEditorInstance ( _
    createDocFlags As UInteger, _
    moniker As String, _
    physicalView As String, _
    pHier 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 cancelled As Integer _
) As Integer
public virtual int CreateEditorInstance(
    uint createDocFlags,
    string moniker,
    string physicalView,
    IVsHierarchy pHier,
    uint itemid,
    IntPtr existingDocData,
    out IntPtr docView,
    out IntPtr docData,
    out string editorCaption,
    out Guid cmdUI,
    out int cancelled
)

参数

  • createDocFlags
    类型:System.UInt32
    定义条件下创建核心编辑器的标志。
  • moniker
    类型:System.String
    文档的标记标识符的字符串形式在项目系统的。在文档中的文件,它总是文件的路径。此参数也许还用于指定文档不是文件。例如,在一个面向数据库项目,此参数可以包含在表中引用记录的字符串。
  • itemid
    类型:System.UInt32
    核心编辑器实例的项 ID。
  • existingDocData
    类型:System.IntPtr
    必须位于运行注册文档表 (RDT)的 docData 对象。此参数用于确定文档缓冲区 (文档数据对象) 是否已创建。在编辑工厂请求创建一个辅助视图,则此参数是一个非NULL 无文档缓冲区。
  • docView
    类型:System.IntPtr%
    记录视图对象。返回 NULL ,如果外部编辑现有; 否则返回文档的视图。
  • docData
    类型:System.IntPtr%
    文档数据对象。返回文档的缓冲区。
  • editorCaption
    类型:System.String%
    文档窗口的文档编辑器中定义的初始声明。这通常是在方括号括起来的字符串,例如 “[]”窗体。此值作为输入参数传递给 CreateDocumentWindow 方法。如果文件是只读 [] 文件中的加载过程中,该声明将设置为。
  • cmdUI
    类型:System.Guid%
    返回命令 UI GUID。激活时,时,此 GUID 为活动状态此编辑器。是显示在编辑器的任何 UI 元素必须使用此 GUID。此 GUID 在它指示附属 DLL 的 .ctc 文件应显示哪些菜单和工具栏,在文档处于活动状态时。

返回值

类型:System.Int32
如果方法成功,则返回 S_OK。如果失败,它会返回一个错误代码。

实现

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

备注

Visual Studio 核心编辑器是主命令处理程序。

.NET Framework 安全性

请参见

参考

EditorFactory 类

Microsoft.VisualStudio.Package 命名空间