通过

IVsExternalFilesManager2.AddDocumentEx 方法

  • 项目

以编程方式通知杂项文件项目添加节点，允许访问图标的控件节点的，因此对于编辑器提供机会对上下文服务的查询。

命名空间：  Microsoft.VisualStudio.Shell.Interop
程序集：  Microsoft.VisualStudio.Shell.Interop（在 Microsoft.VisualStudio.Shell.Interop.dll 中）

语法

声明
Function AddDocumentEx ( _
    dwCDW As UInteger, _
    pszMkDocument As String, _
    punkDocView As IntPtr, _
    punkDocData As IntPtr, _
    ByRef rguidEditorType As Guid, _
    pszPhysicalView As String, _
    ByRef rguidCmdUI As Guid, _
    pszOwnerCaption As String, _
    pszEditorCaption As String, _
    pspContext As IServiceProvider, _
    hicon As IntPtr, _
    <OutAttribute> ByRef pfDefaultPosition As Integer, _
    <OutAttribute> ByRef ppWindowFrame As IVsWindowFrame _
) As Integer

int AddDocumentEx(
    uint dwCDW,
    string pszMkDocument,
    IntPtr punkDocView,
    IntPtr punkDocData,
    ref Guid rguidEditorType,
    string pszPhysicalView,
    ref Guid rguidCmdUI,
    string pszOwnerCaption,
    string pszEditorCaption,
    IServiceProvider pspContext,
    IntPtr hicon,
    out int pfDefaultPosition,
    out IVsWindowFrame ppWindowFrame
)

参数

  • pszMkDocument
    类型：System.String
    [in] 文档的路径。此路径由对运行的视图文档表 (RDT)注册的环境。
  • punkDocView
    类型：System.IntPtr
    [in] 为 IUnknown 接口的指针在此窗口中将显示文档的视图对象的。
  • punkDocData
    类型：System.IntPtr
    [in] 保留此的文档数据对象的 IUnknown 接口的指针在具有视图或数据分隔的情况文档。例如，核心文本编辑器具有文本视图对象 (VsTextView 对象) 和文本缓冲区对象 (VsTextBuffer对象)。此参数可以为 nullnull 引用（在 Visual Basic 中为 Nothing）。通过 nullnull 引用（在 Visual Basic 中为 Nothing） 使该环境创建 punkDocData 的默认实现的实例委托调用方的。
  • rguidEditorType
    类型：System.Guid%
    [in] 创建文档查看实例和文档 dataobjects 编辑工厂的唯一标识符。这应该是 GUID_NULL，如果文档中构造使用编辑工厂 (即实例是由特定项目的私有知识创建)。
  • pszPhysicalView
    类型：System.String
    [in] 标识编辑的物理视图类型的字符串。
  • rguidCmdUI
    类型：System.Guid%
    [in] 指定指示的 GUID 要设置菜单应合并到主菜单栏，在文档处于活动状态的。它用于打开命令和工具窗口的可见性使用。
  • pszOwnerCaption
    类型：System.String
    [in] 文档所有者定义的初始声明 (即项目) 文档窗口中。这通常是以下格式:“ProjectName – ItemName”。
  • pszEditorCaption
    类型：System.String
    [in] 文档窗口的文档编辑器中定义的初始声明。这通常是在方括号括起来的字符串 (例如，仅读取 [])。此参数的初始值返回为 CreateEditorInstance [out] 方法的参数。
  • pspContext
    类型：Microsoft.VisualStudio.OLE.Interop.IServiceProvider
    [out] 为 IServiceProvider 接口的指针。可以为 nullnull 引用（在 Visual Basic 中为 Nothing）。这是调用方提供的附加服务提供程序 (杂项文件项目) 可以为调用方提供额外的上下文 (通过服务) 写入一个嵌入编辑。因此，在中，当嵌入对象创建一个服务请求时，框架尝试满足此请求。如果帧未提供服务， pSP 将尝试。如果没有找到服务存在，则环境的全局服务提供程序可以查询。
  • hicon
    类型：System.IntPtr
    [in] 指定句柄图标。允许您为 " 杂项 " 节点指定图标。
  • pfDefaultPosition
    类型：System.Int32%
    [out] ，如果调用方不希望窗口中，默认位置信息可以为空。true ，如果环境没有任何信息保存有关此工具窗口的最后一个位置 (即未找到 guidPersistenceSlot )，因此它在某些默认位置放置了屏幕。false ，如果将此窗口用户最后查找和大小之后的位置。
  • ppWindowFrame
    类型：Microsoft.VisualStudio.Shell.Interop.IVsWindowFrame%
    [out] 对包含此编辑框架的指针，可用于操作位置、大小、说明和窗口的其他属性。它还可用于获取嵌入 (即 punkDocView) 或 punkDocData的 IUnknown 接口指针。

返回值

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

备注

COM 签名

从 vsshell.idl:

HRESULT IVsExternalFilesManager2::AddDocumentEx(
   [in] VSCREATEDOCWIN dwCDW,
   [in] LPCOLESTR pszMkDocument,
   [in] IUnknown *punkDocView,
   [in] IUnknown *punkDocData,
   [in] REFGUID rguidEditorType,
   [in] LPCOLESTR pszPhysicalView,
   [in] REFGUID rguidCmdUI,
   [in] LPCOLESTR pszOwnerCaption,
   [in] LPCOLESTR pszEditorCaption,
   [in] IServiceProvider *pspContext,
   [in] HICON hIcon,
   [out] BOOL *pfDefaultPosition,
   [out] IVsWindowFrame **ppWindowFrame
);

类似于 AddDocument 方法。 提供指定 " 杂项 " 图标的其他功能并为编辑器提供机会对上下文服务的查询。

.NET Framework 安全性

请参见

参考

IVsExternalFilesManager2 接口

Microsoft.VisualStudio.Shell.Interop 命名空间