IVsUIShellOpenDocument.OpenSpecificEditor 方法

定义

命名空间:

Microsoft.VisualStudio.Shell.Interop

程序集:

Microsoft.VisualStudio.Interop.dll

打开指定的编辑器。

public:
 int OpenSpecificEditor(System::UInt32 grfOpenSpecific, System::String ^ pszMkDocument, Guid % rguidEditorType, System::String ^ pszPhysicalView, Guid % rguidLogicalView, System::String ^ pszOwnerCaption, Microsoft::VisualStudio::Shell::Interop::IVsUIHierarchy ^ pHier, System::UInt32 itemid, IntPtr punkDocDataExisting, Microsoft::VisualStudio::OLE::Interop::IServiceProvider ^ pSPHierContext, [Runtime::InteropServices::Out] Microsoft::VisualStudio::Shell::Interop::IVsWindowFrame ^ % ppWindowFrame);

public int OpenSpecificEditor (uint grfOpenSpecific, string pszMkDocument, ref Guid rguidEditorType, string pszPhysicalView, ref Guid rguidLogicalView, string pszOwnerCaption, Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy pHier, uint itemid, IntPtr punkDocDataExisting, Microsoft.VisualStudio.OLE.Interop.IServiceProvider pSPHierContext, out Microsoft.VisualStudio.Shell.Interop.IVsWindowFrame ppWindowFrame);

abstract member OpenSpecificEditor : uint32 * string * Guid * string * Guid * string * Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy * uint32 * nativeint * Microsoft.VisualStudio.OLE.Interop.IServiceProvider * IVsWindowFrame -> int

Public 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, ByRef ppWindowFrame As IVsWindowFrame) As Integer

参数

grfOpenSpecific

UInt32

[in]从枚举获取 __VSOSPEFLAGS 的值。

pszMkDocument

String

[in]项目系统中文档的唯一名字对象标识符的字符串形式，例如文件的完整路径。 在非文件情况下，此标识符通常采用 URL 的形式。

rguidEditorType

Guid

[in]编辑器类型的唯一标识符。

pszPhysicalView

String

[in]物理视图的名称。 如果 null为 ，则环境在编辑器工厂上调用 MapLogicalView(Guid, String) 以确定与逻辑视图对应的物理视图。 在这种情况下， null 不指定主视图，而是指示你不知道哪个视图对应于逻辑视图。

rguidLogicalView

Guid

[in]标识逻辑视图的 GUID。 有关逻辑视图 GUID 的列表，请参阅逻辑视图和物理视图。 如果在文档视图对象上实现 IVsMultiViewDocumentView ，则传递给 rguidLogicalView 参数的值将确定在实例化编辑器时显示编辑器窗口时激活哪个视图。 通过指定逻辑视图 GUID，的 InitializeEditorInstance(UInt32, IntPtr, IntPtr, String, Guid, String, Guid, String, String, IVsUIHierarchy, UInt32, IntPtr, IServiceProvider, Guid, IVsWindowFrame) 调用方可以请求与调用方请求视图的原因匹配的特定视图。 例如，调用方将指定LOGVIEWID_Debugging以获取适合调试视图的视图，或 LOGVIEWID_TextView 获取适用于文本编辑器 (即实现 IVsCodeWindow) 视图的视图。

pszOwnerCaption

String

[in]文档所有者定义的初始描述文字 (即文档窗口的项目) 。 这通常采用以下形式：“ProjectName – ItemName”。

pHier

IVsUIHierarchy

[in] 指向 IVsUIHierarchy 接口的指针。

itemid

UInt32

[in]指定编辑器的 UI 层次结构项标识符。 有关更多信息，请参见VSITEMID。

punkDocDataExisting

IntPtr

nativeint

[in] 指向 IUnknown 接口的指针。

pSPHierContext

IServiceProvider

[in] 指向 IServiceProvide 接口的指针。

ppWindowFrame

IVsWindowFrame

[out， retval]指向接口的 IVsWindowFrame 指针。

返回

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  
);