IVsUIShellOpenDocument.OpenSpecificEditor 方法

定義

命名空間:

Microsoft.VisualStudio.Shell.Interop

組件:

Microsoft.VisualStudio.Interop.dll

套件:

Microsoft.VisualStudio.Interop v17.9.37000

開啟指定的編輯器。

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]專案系統中檔唯一 Moniker 識別碼的字串形式，例如檔案的完整路徑。 在非檔案案例中，此識別碼通常是 URL 的形式。

rguidEditorType

Guid

[in]編輯器類型的唯一識別碼。

pszPhysicalView

String

[in]實體檢視的名稱。 如果 null 為 ，則環境會在編輯器處理站上呼叫 MapLogicalView(Guid, String) ，以判斷對應至邏輯檢視的實體檢視。 在此情況下， null 不會指定主要檢視，而是表示您不知道哪個檢視對應至邏輯檢視。

rguidLogicalView

Guid

[in]識別邏輯檢視的 GUID。 如需邏輯檢視 GUIDS 的清單，請參閱邏輯檢視和實體檢視。 如果您在檔檢視物件上實 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  
);