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
)
参数
- grfOpenSpecific
类型:System.UInt32
[in] 从 __VSOSPEFLAGS 枚举采用的值。
- 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”。
- pHier
类型:Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy
[in] 为 IVsUIHierarchy 接口的指针。
- itemid
类型:System.UInt32
[in] UI 层次结构指定编辑器的项 ID。有关更多信息,请参见VSITEMID。
- punkDocDataExisting
类型:System.IntPtr
[in] 为 IUnknown 接口的指针。
- pSPHierContext
类型:Microsoft.VisualStudio.OLE.Interop.IServiceProvider
[in] 为 IServiceProvide 接口的指针。
- ppWindowFrame
类型:Microsoft.VisualStudio.Shell.Interop.IVsWindowFrame%
[out, retval] 为 IVsWindowFrame 接口的指针。
返回值
类型: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 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。