IVsAsyncShellOpenDocument.OpenDocumentViaProjectWithSpecificAsync Metoda

Definice

Obor názvů:

Microsoft.VisualStudio.Shell.Interop

Sestavení:

Microsoft.VisualStudio.Interop.dll

Balíček:

Microsoft.VisualStudio.Interop v17.9.37000

Najde zadaný projekt pro otevření tohoto dokumentu.

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

Parametry

documentMoniker

String

Řetězcová forma jedinečného identifikátoru monikeru dokumentu v systému projektu, například úplná cesta k souboru. V nezadávkovaných případech má tento identifikátor často podobu adresy URL.

specificEditorFlags

UInt32

Příznaky, jejichž hodnoty jsou převzaty z __VSSPECIFICEDITORFLAGS výčtu.

editorType

Guid

Jedinečný identifikátor typu editoru.

physicalView

String

Jedinečný identifikátor fyzického zobrazení.

logicalView

Guid

Identifikující Guid logické zobrazení. Výchozí zobrazení je VSConstants.LOGVIEWID_Primary a každý editor musí toto zobrazení podporovat.

Pokud editor implementuje IVsMultiViewDocumentView objekt zobrazení dokumentu, hodnota předaná do ActivateLogicalView(Guid), která určuje, které zobrazení je aktivováno při zobrazení okna editoru.

Zadáním logického zobrazení Guidmůžete požádat o konkrétní zobrazení, které odpovídá důvodu, proč o zobrazení žádáte. Můžete například zadat VSConstants.LOGVIEWID_Debugging , aby se získalo zobrazení vhodné pro ladění, nebo VSConstants.LOGVIEWID_TextView zobrazení vhodné pro textový editor (to znamená zobrazení, které implementuje IVsCodeWindow).

Návraty

IVsTask

Úloha představující operaci otevření. Výsledkem úkolu je IVsAsyncOpenDocumentResult objekt.

Poznámky

Úloha vrácená touto metodou neindikuje, že byly načteny zobrazení dokumentu a docdata. Další podrobnosti najdete DocumentLoadTask v tématu .

Tuto metodu používají balíčky VSPackage, které nejsou projekty, které potřebují otevřít dokument v konkrétním editoru, ale nezajímá je, který projekt soubor otevře. Chcete-li volat tuto metodu z VSPackage, musíte přesně vědět, který objekt pro editor chcete a přesně, které okno má objekt pro vytváření editoru vytvořit (to znamená fyzické zobrazení). Logické zobrazení zadané v parametru logicalView dále umožňuje určit, která karta má být zobrazena editorem, pokud editor implementuje IVsMultiViewDocumentView.

Tato metoda volá OpenItem(UInt32, Guid, IntPtr, IVsWindowFrame). Pokud žádný projekt nemůže soubor obsluhovat a projekt Různé soubory ještě není k dispozici, prostředí pak vytvoří projekt Různé soubory a zkusí to znovu.