IVsAsyncShellOpenDocument.OpenSpecificEditorAsync Metoda

Definice

Obor názvů:

Microsoft.VisualStudio.Shell.Interop

Sestavení:

Microsoft.VisualStudio.Interop.dll

Balíček:

Microsoft.VisualStudio.Interop v17.9.37000

Asynchronně otevře dokument pomocí zadaného editoru.

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

Parametry

openSpecificEditorFlags

UInt32

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

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.

editorType

Guid

Objekt , Guid který identifikuje, že se má editor použít k otevření souboru.

physicalView

String

Název fyzického zobrazení nebo null.

Pokud null, prostředí volá MapLogicalView(Guid, String) objekt pro vytváření editoru k určení fyzického zobrazení, které odpovídá logickému zobrazení. V tomto případě null nástroj neurčuje primární zobrazení, ale spíše indikuje, že nevíte, které zobrazení odpovídá logickému 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).

ownerCaption

String

Počáteční popis definované vlastníkem dokumentu (tj. projektem) pro okno dokumentu. Často se jedná o tento formát: ProjectName – ItemName.

hierarchy

IVsUIHierarchy

Odkaz na IVsUIHierarchy soubor, který je vlastníkem dokumentu.

itemId

UInt32

Identifikátor položky hierarchie uživatelského rozhraní standardního editoru. Další informace naleznete zde VSConstants.VSITEMID.

shouldGetDocDataFromRdt

Boolean

Pokud true, použije prostředí datový objekt dokumentu získaný ze spuštěné tabulky dokumentů. V opačném případě služba dokument otevře pomocí dat dokumentace předaných službě docData.

docData

Object

Odkaz na datový objekt dokumentu položky, která se má otevřít, nebo null. Tato hodnota předaná tomuto parametru se ignoruje, pokud shouldGetDocDataFromRdt je truehodnota .

serviceProvider

IServiceProvider

Odkaz na IServiceProvider.

Návraty

IVsTask

Úloha představující, že byla spuštěna operace otevření. Výsledkem úlohy je odkaz na IVsAsyncOpenDocumentResult, pokud byl dokument otevřen v prostředí. V opačném případě null.

Poznámky

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