IVsAsyncShellOpenDocument.OpenDocumentViaProjectWithSpecificAsync Metoda

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.VisualStudio.Shell.Interop

Zestaw:: Microsoft.VisualStudio.Interop.dll

Pakiet:: Microsoft.VisualStudio.Interop v17.9.37000

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Znajduje określony projekt do otwarcia tego 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

Formularz ciągu unikatowego identyfikatora moniker dokumentu w systemie projektu, na przykład pełna ścieżka do pliku. W przypadkach niezwiązanych z plikami ten identyfikator jest często w postaci adresu URL.

specificEditorFlags: UInt32

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

editorType: Guid

Unikatowy identyfikator typu edytora.

physicalView: String

Unikatowy identyfikator widoku fizycznego.

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), która 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ą żądania 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).

Zwraca

IVsTask

Zadanie reprezentujące operację otwierania. Wynikiem zadania jest IVsAsyncOpenDocumentResult obiekt.

Uwagi

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

Ta metoda jest używana przez pakiety VSPackage, które nie są projektami, które muszą otworzyć dokument w określonym edytorze, ale nie obchodzi, który projekt otwiera plik. Aby wywołać tę metodę z pakietu VSPackage, musisz dokładnie wiedzieć, która fabryka edytora ma być tworzona, i dokładnie to, które okno ma zostać utworzone przez fabrykę edytora (czyli widok fizyczny). Widok logiczny określony w parametrze logicalView dodatkowo pozwala określić, która karta powinna być wyświetlana przez edytor, jeśli edytor implementuje IVsMultiViewDocumentView.

Ta metoda wywołuje metodę OpenItem(UInt32, Guid, IntPtr, IVsWindowFrame). Jeśli żaden projekt nie może obsłużyć pliku, a projekt Różne pliki nie jest jeszcze obecny, środowisko tworzy projekt Różne pliki i spróbuje ponownie.

Dotyczy