IVsUIShellOpenDocument.OpenSpecificEditor 方法

打开一个指定编辑器。

命名空间:  Microsoft.VisualStudio.Shell.Interop
程序集:  Microsoft.VisualStudio.Shell.Interop(在 Microsoft.VisualStudio.Shell.Interop.dll 中)

语法

声明
Function OpenSpecificEditor ( _
    grfOpenSpecific As UInteger, _
    pszMkDocument As String, _
    ByRef rguidEditorType As Guid, _
    pszPhysicalView As String, _
    ByRef rguidLogicalView As Guid, _
    pszOwnerCaption As String, _
    pHier As IVsUIHierarchy, _
    itemid As UInteger, _
    punkDocDataExisting As IntPtr, _
    pSPHierContext As IServiceProvider, _
    <OutAttribute> ByRef ppWindowFrame As IVsWindowFrame _
) As Integer
int OpenSpecificEditor(
    uint grfOpenSpecific,
    string pszMkDocument,
    ref Guid rguidEditorType,
    string pszPhysicalView,
    ref Guid rguidLogicalView,
    string pszOwnerCaption,
    IVsUIHierarchy pHier,
    uint itemid,
    IntPtr punkDocDataExisting,
    IServiceProvider pSPHierContext,
    out IVsWindowFrame ppWindowFrame
)

参数

  • pszMkDocument
    类型:System.String
    [in] 字符串文档的唯一标记标识符形式对项目系统,例如,完整路径到文件。在 URL 的形式,在非文件种情况下,此标识符常常是。
  • rguidEditorType
    类型:System.Guid%
    [in] 编辑类型的唯一标识符。
  • pszPhysicalView
    类型:System.String
    [in] 物理视图的名称。如果 nullnull 引用(在 Visual Basic 中为 Nothing),环境对编辑工厂的 MapLogicalView 确定对应于逻辑视图的物理视图。在这种情况下, nullnull 引用(在 Visual Basic 中为 Nothing) 不指定主视图,,而是指示您不知道哪种看法对应于逻辑视图。
  • rguidLogicalView
    类型:System.Guid%
    [in] 标识逻辑视图的 GUID。有关逻辑上 GUIDS 列表,请参见逻辑视图和物理视图。如果实现在文档视图对象的 IVsMultiViewDocumentView ,则将传递给 rguidLogicalView 参数确定激活哪个视图,编辑窗口显示时,编辑器实例化时。通过指定逻辑视图 GUID, InitializeEditorInstance 的调用方才能够请求与该原因调用方请求视图的特定视图。例如,调用方将指定 LOGVIEWID_Debugging 获取视图适合于调试视图或 LOGVIEWID_TextView 获取视图适合于文本编辑器 (即该视图实现 IVsCodeWindow)。
  • pszOwnerCaption
    类型:System.String
    [in] 文档所有者定义的初始声明 (即项目) 文档窗口中。这通常是窗体:“ProjectName – ItemName”。
  • itemid
    类型:System.UInt32
    [in] UI 层次结构指定编辑器的项 ID。有关更多信息,请参见VSITEMID。
  • punkDocDataExisting
    类型:System.IntPtr
    [in] 为 IUnknown 接口的指针。

返回值

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

备注

COM 签名

从 vsshell.idl:

HRESULT IVsUIShellOpenDocument::OpenSpecificEditor(
   [in] VSOSPEFLAGS grfOpenSpecific,
   [in] LPCOLESTR pszMkDocument,
   [in] REFGUID rguidEditorType,
   [in] LPCOLESTR pszPhysicalView,
   [in] REFGUID rguidLogicalView,
   [in] LPCOLESTR pszOwnerCaption,
   [in] IVsUIHierarchy *pHier,
   [in] VSITEMID itemid,
   [in] IUnknown *punkDocDataExisting,
   [in] IServiceProvider *pSPHierContext,
   [out, retval] IVsWindowFrame **ppWindowFrame
);

.NET Framework 安全性

请参见

参考

IVsUIShellOpenDocument 接口

Microsoft.VisualStudio.Shell.Interop 命名空间