IVsUIShellOpenDocument.OpenSpecificEditor Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Membuka editor tertentu.
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
Parameter
- grfOpenSpecific
- UInt32
[in] Nilai yang __VSOSPEFLAGS diambil dari enumerasi.
- pszMkDocument
- String
[in] Bentuk string pengidentifikasi moniker unik dokumen dalam sistem proyek, misalnya, jalur lengkap ke file. Dalam kasus non-file, pengidentifikasi ini sering dalam bentuk URL.
- rguidEditorType
- Guid
[in] Pengidentifikasi unik jenis editor.
- pszPhysicalView
- String
[in] Nama tampilan fisik. Jika null
, lingkungan memanggil MapLogicalView(Guid, String) di pabrik editor untuk menentukan tampilan fisik yang sesuai dengan tampilan logis. Dalam hal ini, null
tidak menentukan tampilan utama, melainkan menunjukkan bahwa Anda tidak tahu tampilan mana yang sesuai dengan tampilan logis.
- rguidLogicalView
- Guid
[in] GUID mengidentifikasi tampilan logis. Untuk daftar GUID TAMPILAN logis, lihat Tampilan Logis dan Tampilan Fisik. Jika Anda menerapkan IVsMultiViewDocumentView pada objek tampilan dokumen Anda, maka nilai yang diteruskan ke rguidLogicalView
parameter menentukan tampilan mana yang diaktifkan saat jendela editor ditampilkan saat editor dibuat. Dengan menentukan GUID tampilan logis, pemanggil InitializeEditorInstance(UInt32, IntPtr, IntPtr, String, Guid,
String, Guid, String, String, IVsUIHierarchy, UInt32, IntPtr,
IServiceProvider, Guid, IVsWindowFrame) dapat meminta tampilan tertentu yang cocok dengan alasan pemanggil meminta tampilan. Misalnya, pemanggil akan menentukan LOGVIEWID_Debugging untuk mendapatkan tampilan yang sesuai untuk tampilan penelusuran kesalahan, atau LOGVIEWID_TextView untuk mendapatkan tampilan yang sesuai untuk editor teks (yaitu, tampilan yang mengimplementasikan IVsCodeWindow).
- pszOwnerCaption
- String
[in] Caption awal yang ditentukan oleh pemilik dokumen (yaitu, proyek) untuk jendela dokumen. Ini sering kali berupa: "ProjectName – ItemName."
- pHier
- IVsUIHierarchy
[in] Arahkan ke IVsUIHierarchy antarmuka.
- itemid
- UInt32
[in] Pengidentifikasi item hierarki UI untuk editor yang ditentukan. Untuk informasi selengkapnya, lihat VSITEMID
.
- punkDocDataExisting
-
IntPtr
nativeint
[in] Arahkan ke IUnknown
antarmuka.
- pSPHierContext
- IServiceProvider
[in] Arahkan ke IServiceProvide
antarmuka.
- ppWindowFrame
- IVsWindowFrame
[out, retval] Arahkan ke IVsWindowFrame antarmuka.
Mengembalikan
Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kode kesalahan akan ditampilkan.
Keterangan
Tanda Tangan COM
Dari 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
);