IVsAsyncShellOpenDocument.OpenDocumentViaProjectWithSpecificAsync 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
尋找要開啟此檔的指定專案。
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
參數
- documentMoniker
- String
項目系統中檔唯一 Moniker 識別符的字串形式,例如檔案的完整路徑。 在非檔案案例中,此標識碼通常是URL的形式。
- specificEditorFlags
- UInt32
其值取自 __VSSPECIFICEDITORFLAGS 列舉的旗標。
- editorType
- Guid
編輯器類型的唯一標識碼。
- physicalView
- String
實體檢視的唯一標識碼。
- logicalView
- Guid
, Guid 識別邏輯檢視。 默認檢視是 VSConstants.LOGVIEWID_Primary
,而且每個編輯器都必須支援該檢視。
如果編輯器在文件檢視對象上實 IVsMultiViewDocumentView 作,則傳遞給 ActivateLogicalView(Guid)的值會決定在顯示編輯器視窗時啟動的檢視。
藉由指定邏輯檢視,您可以要求符合您要求檢視 Guid原因的特定檢視。
例如,指定 VSConstants.LOGVIEWID_Debugging
以取得適合偵錯的檢視,或 VSConstants.LOGVIEWID_TextView
取得適用於文本編輯器 (的檢視,也就是實 IVsCodeWindow 作) 的檢視。
傳回
表示開啟作業的工作。 工作的結果是 IVsAsyncOpenDocumentResult 物件。
備註
這個方法所傳回的工作不會指出文件檢視和 docdata 已載入。 如需更多詳細資料,請參閱 DocumentLoadTask \(英文\)。
VSPackages 會使用這個方法,這些不是需要在特定編輯器中開啟文件的專案,但不小心哪個專案會開啟檔案。 若要從 VSPackage 呼叫這個方法,您必須確切知道您想要的編輯器處理站,以及想要編輯器處理站建立 (也就是實體檢視) 的確切視窗。 進一步在 參數中指定的 logicalView
邏輯檢視可讓您指定編輯器實作 時 IVsMultiViewDocumentView,編輯器應該顯示哪一個索引標籤。
此方法會呼叫 OpenItem(UInt32, Guid, IntPtr, IVsWindowFrame)。 如果沒有任何專案可以服務檔案,且 [其他檔案] 專案尚未存在,則環境會建立 [其他檔案] 專案,然後再試一次。