IVsUIShellOpenDocument.OpenSpecificEditor メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したエディターを開きます。
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
[入力]列挙から取得された __VSOSPEFLAGS 値。
- pszMkDocument
- String
[入力]プロジェクト システム内のドキュメントの一意のモニカー識別子の文字列形式 (ファイルへの完全パスなど)。 ファイル以外の場合、多くの場合、この識別子は URL の形式になります。
- rguidEditorType
- Guid
[入力]エディターの種類の一意識別子。
- pszPhysicalView
- String
[入力]物理ビューの名前。 の場合 null
、環境はエディター ファクトリで を呼び出 MapLogicalView(Guid, String) して、論理ビューに対応する物理ビューを決定します。 この場合、 null
はプライマリ ビューを指定するのではなく、論理ビューに対応するビューがわからないことを示します。
- rguidLogicalView
- Guid
[入力]論理ビューを識別する GUID。 論理ビュー GUID の一覧については、「論理ビューと物理ビュー」を参照してください。 ドキュメント ビュー オブジェクトに を実装 IVsMultiViewDocumentView すると、 パラメーターに渡される値によって、エディターのインスタンス化時に rguidLogicalView
エディター ウィンドウが表示されるときにアクティブ化されるビューが決まります。 の呼び出し元は、論理ビュー GUID を指定することで、呼び出し元 InitializeEditorInstance(UInt32, IntPtr, IntPtr, String, Guid,
String, Guid, String, String, IVsUIHierarchy, UInt32, IntPtr,
IServiceProvider, Guid, IVsWindowFrame) がビューを要求している理由と一致する特定のビューを要求できます。 たとえば、呼び出し元は、デバッグ ビューに適したビューを取得したり、テキスト エディターに適したビュー (つまり を実装するビュー) を取得したり LOGVIEWID_TextView するために、LOGVIEWID_Debuggingを指定します IVsCodeWindow。
- pszOwnerCaption
- String
[入力]初期キャプションドキュメント ウィンドウのドキュメント所有者 (つまりプロジェクト) によって定義されます。 これは多くの場合、"ProjectName – ItemName" という形式です。
- pHier
- IVsUIHierarchy
[入力] IVsUIHierarchy インターフェイスへのポインター。
- itemid
- UInt32
[入力]指定したエディターの UI 階層項目識別子。 詳細については、「VSITEMID
」を参照してください。
- punkDocDataExisting
-
IntPtr
nativeint
[入力] IUnknown
インターフェイスへのポインター。
- pSPHierContext
- IServiceProvider
[入力] IServiceProvide
インターフェイスへのポインター。
- ppWindowFrame
- IVsWindowFrame
[out, retval]インターフェイスへの IVsWindowFrame ポインター。
戻り値
メソッドが成功した場合は 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
);