IVsAsyncShellOpenDocument.OpenSpecificEditorAsync Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualStudio.Shell.Interop

Zestaw:

Microsoft.VisualStudio.Interop.dll

Pakiet:

Microsoft.VisualStudio.Interop v17.9.37000

Asynchronicznie otwiera dokument przy użyciu określonego edytora.

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

Flagi, których wartości są pobierane z wyliczenia __VSOSPEFLAGS .

documentMoniker

String

Forma ciągu unikatowego identyfikatora moniker dokumentu w systemie projektu, na przykład pełna ścieżka do pliku. W przypadkach innych niż pliki ten identyfikator jest często w postaci adresu URL.

editorType

Guid

Element Guid identyfikujący edytor, który służy do otwierania pliku.

physicalView

String

Nazwa widoku fizycznego lub null.

Jeśli nullśrodowisko wywołuje MapLogicalView(Guid, String) fabrykę edytorów w celu określenia widoku fizycznego odpowiadającego widokowi logicznemu. W tym przypadku null nie określa widoku podstawowego, ale raczej wskazuje, że nie wiadomo, który widok odpowiada widokowi logicznemu.

logicalView

Guid

Identyfikowanie Guid widoku logicznego. Widok domyślny to VSConstants.LOGVIEWID_Primary i każdy edytor musi obsługiwać ten widok.

Jeśli edytor implementuje IVsMultiViewDocumentView obiekt widoku dokumentu, wartość przekazana do ActivateLogicalView(Guid)elementu określa, który widok jest aktywowany po wyświetleniu okna edytora.

Określając widok Guidlogiczny, możesz zażądać określonego widoku zgodnego z przyczyną, dla której żądasz widoku. Na przykład określ VSConstants.LOGVIEWID_Debugging , aby uzyskać widok odpowiedni do debugowania lub VSConstants.LOGVIEWID_TextView uzyskać widok odpowiedni dla edytora tekstów (czyli widok implementujący IVsCodeWindow).

ownerCaption

String

Początkowe podpis zdefiniowane przez właściciela dokumentu (czyli projektu) dla okna dokumentu. Jest to często postać: "ProjectName — ItemName".

hierarchy

IVsUIHierarchy

Odwołanie do IVsUIHierarchy dokumentu będącego właścicielem dokumentu.

itemId

UInt32

Identyfikator elementu hierarchii interfejsu użytkownika edytora standardowego. Aby uzyskać więcej informacji, zobacz VSConstants.VSITEMID.

shouldGetDocDataFromRdt

Boolean

Jeśli trueprogram , środowisko będzie używać obiektu danych dokumentu uzyskanego z uruchomionej tabeli dokumentów. W przeciwnym razie usługa otworzy dokument przy użyciu danych dokumentu przekazanych do docData.

docData

Object

Odwołanie do obiektu danych dokumentu elementu do otwarcia lub null. Ta wartość przekazana do tego parametru jest ignorowana, jeśli shouldGetDocDataFromRdt jest to true.

serviceProvider

IServiceProvider

Odwołanie do .IServiceProvider

Zwraca

IVsTask

Zadanie reprezentujące, że rozpoczęto operację otwierania. Wynikiem zadania jest odwołanie do elementu IVsAsyncOpenDocumentResult, jeśli dokument został otwarty w środowisku; w przeciwnym razie null.

Uwagi

Zadanie zwrócone przez tę metodę nie wskazuje, że widok dokumentu i dane docdata zostały załadowane. Aby uzyskać więcej informacji, zobacz DocumentLoadTask .