IVsAsyncShellOpenDocument.OpenSpecificEditorAsync Metode

Definisi

Ruang nama:

Microsoft.VisualStudio.Shell.Interop

Rakitan:

Microsoft.VisualStudio.Interop.dll

Paket:

Microsoft.VisualStudio.Interop v17.9.37000

Secara asinkron membuka dokumen menggunakan editor yang ditentukan.

public Microsoft.VisualStudio.Shell.Interop.IVsTask OpenSpecificEditorAsync (uint openSpecificEditorFlags, string documentMoniker, Guid editorType, string? physicalView, Guid logicalView, string? ownerCaption, Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy? hierarchy, uint itemId, bool shouldGetDocDataFromRdt, object? docData, Microsoft.VisualStudio.OLE.Interop.IServiceProvider serviceProvider);

abstract member OpenSpecificEditorAsync : uint32 * string * Guid * string * Guid * string * Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy * uint32 * bool * obj * Microsoft.VisualStudio.OLE.Interop.IServiceProvider -> Microsoft.VisualStudio.Shell.Interop.IVsTask

Public Function OpenSpecificEditorAsync (openSpecificEditorFlags As UInteger, documentMoniker As String, editorType As Guid, physicalView As String, logicalView As Guid, ownerCaption As String, hierarchy As IVsUIHierarchy, itemId As UInteger, shouldGetDocDataFromRdt As Boolean, docData As Object, serviceProvider As IServiceProvider) As IVsTask

Parameter

openSpecificEditorFlags

UInt32

Bendera yang nilainya diambil dari __VSOSPEFLAGS enumerasi.

documentMoniker

String

Bentuk string pengidentifikasi moniker unik dokumen dalam sistem proyek, misalnya, jalur lengkap ke file. Dalam kasus non-file, pengidentifikasi ini sering dalam bentuk URL.

editorType

Guid

Guid Yang mengidentifikasi ke editor yang digunakan untuk membuka file.

physicalView

String

Nama tampilan fisik atau null.

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.

logicalView

Guid

Guid Mengidentifikasi tampilan logis. Tampilan default adalah VSConstants.LOGVIEWID_Primary dan setiap editor harus mendukung tampilan tersebut.

Jika editor mengimplementasikan IVsMultiViewDocumentView pada objek tampilan dokumen, maka nilai yang diteruskan ke ActivateLogicalView(Guid), yang menentukan tampilan mana yang diaktifkan saat jendela editor ditampilkan.

Dengan menentukan tampilan Guidlogis , Anda dapat meminta tampilan tertentu yang cocok dengan alasan Anda meminta tampilan. Misalnya, tentukan VSConstants.LOGVIEWID_Debugging untuk mendapatkan tampilan yang sesuai untuk penelusuran kesalahan, atau VSConstants.LOGVIEWID_TextView untuk mendapatkan tampilan yang sesuai untuk editor teks (yaitu, tampilan yang mengimplementasikan IVsCodeWindow).

ownerCaption

String

Caption awal yang ditentukan oleh pemilik dokumen (yaitu, proyek) untuk jendela dokumen. Ini sering kali berupa: "ProjectName – ItemName."

hierarchy

IVsUIHierarchy

Referensi ke yang IVsUIHierarchy memiliki dokumen.

itemId

UInt32

Pengidentifikasi item hierarki UI editor standar. Untuk informasi selengkapnya, lihat VSConstants.VSITEMID.

shouldGetDocDataFromRdt

Boolean

Jika true, maka lingkungan akan menggunakan objek data dokumen yang diperoleh dari Tabel Dokumen Yang Berjalan; jika tidak, layanan akan membuka dokumen menggunakan data dokumen yang diteruskan ke docData.

docData

Object

Referensi ke objek data dokumen item untuk dibuka atau null. Nilai yang diteruskan ke parameter ini diabaikan jika shouldGetDocDataFromRdt adalah true.

serviceProvider

IServiceProvider

Referensi ke IServiceProvider.

Mengembalikan

IVsTask

Tugas yang menunjukkan bahwa operasi terbuka telah dimulai. Hasil tugas adalah referensi ke IVsAsyncOpenDocumentResult, jika dokumen dibuka dalam lingkungan; jika tidak, null.

Keterangan

Tugas yang dikembalikan oleh metode ini tidak menunjukkan bahwa tampilan dokumen dan docdata telah dimuat. Lihat DocumentLoadTask untuk detail selengkapnya.