IVsAsyncShellOpenDocument.OpenDocumentViaProjectWithSpecificAsync Metode

Referensi

Definisi

Ruang nama:: Microsoft.VisualStudio.Shell.Interop

Rakitan:: Microsoft.VisualStudio.Interop.dll

Paket:: Microsoft.VisualStudio.Interop v17.9.37000

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.

Menemukan proyek yang ditentukan untuk membuka dokumen ini.

public Microsoft.VisualStudio.Shell.Interop.IVsTask OpenDocumentViaProjectWithSpecificAsync (string documentMoniker, uint specificEditorFlags, Guid editorType, string? physicalView, Guid logicalView);

abstract member OpenDocumentViaProjectWithSpecificAsync : string * uint32 * Guid * string * Guid -> Microsoft.VisualStudio.Shell.Interop.IVsTask

Public Function OpenDocumentViaProjectWithSpecificAsync (documentMoniker As String, specificEditorFlags As UInteger, editorType As Guid, physicalView As String, logicalView As Guid) As IVsTask

Parameter

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.

specificEditorFlags: UInt32

Bendera yang nilainya diambil dari enumerasi __VSSPECIFICEDITORFLAGS.

editorType: Guid

Pengidentifikasi unik jenis editor.

physicalView: String

Pengidentifikasi unik tampilan fisik.

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

Mengembalikan

IVsTask

Tugas yang mewakili operasi terbuka. Hasil tugas adalah IVsAsyncOpenDocumentResult objek .

Keterangan

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

Metode ini digunakan oleh VSPackages yang bukan proyek yang perlu membuka dokumen di editor tertentu, tetapi tidak peduli proyek mana yang membuka file. Untuk memanggil metode ini dari VSPackage Anda, Anda perlu mengetahui dengan tepat pabrik editor mana yang Anda inginkan dan tepat jendela mana yang Anda inginkan untuk dibuat oleh pabrik editor (yaitu, tampilan fisik). Tampilan logis yang ditentukan dalam logicalView parameter selanjutnya memungkinkan Anda menentukan tab mana yang harus ditampilkan oleh editor jika editor mengimplementasikan IVsMultiViewDocumentView.

Metode ini memanggil OpenItem(UInt32, Guid, IntPtr, IVsWindowFrame). Jika tidak ada proyek yang dapat melayani file dan proyek File Lain-lain belum ada, lingkungan kemudian membuat proyek File Lain-lain dan mencoba lagi.

Berlaku untuk