IVsAsyncShellOpenDocument.OpenSpecificEditorAsync Methode

Referenz

Definition

Namespace:: Microsoft.VisualStudio.Shell.Interop

Assembly:: Microsoft.VisualStudio.Interop.dll

Paket:: Microsoft.VisualStudio.Interop v17.9.37000

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Öffnet asynchron ein Dokument mit dem angegebenen Editor.

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

Parameter

openSpecificEditorFlags: UInt32

Flags, deren Werte aus der __VSOSPEFLAGS Enumeration übernommen werden.

documentMoniker: String

Zeichenfolgenform des eindeutigen Monikerbezeichners des Dokuments im Projektsystem, z. B. der vollständige Pfad zur Datei. Handelt es sich nicht um Dateien, ist dieser Bezeichner oft in Form einer URL angegeben.

editorType: Guid

Eine Guid , die den Editor identifiziert, um die Datei zu öffnen.

physicalView: String

Name der physischen Ansicht oder null.

Wenn null, ruft die Umgebung MapLogicalView(Guid, String) auf der Editorfactory auf, um die physischen Ansicht zu bestimmen, die der logischen Ansicht entspricht. In diesem Fall gibt null nicht die primäre Ansicht an, sondern dass Sie nicht wissen, welche Ansicht der logischen Ansicht entspricht.

logicalView: Guid

Ein Guid , der die logische Ansicht identifiziert. Die Standardansicht ist VSConstants.LOGVIEWID_Primary , und jeder Editor muss diese Ansicht unterstützen.

Wenn der Editor für das Dokumentansichtsobjekt IVsMultiViewDocumentView implementiert, wird der an ActivateLogicalView(Guid)übergebene Wert festgelegt, der bestimmt, welche Ansicht aktiviert wird, wenn das Editorfenster angezeigt wird.

Durch Angeben der logischen Ansicht Guidkönnen Sie die spezifische Ansicht anfordern, die dem Grund entspricht, aus dem Sie die Ansicht anfordern. Geben Sie beispielsweise VSConstants.LOGVIEWID_Debugging an, um die entsprechende Ansicht für das Debuggen zu erhalten, oder geben Sie VSConstants.LOGVIEWID_TextView, um die entsprechende Ansicht für den Text-Editor zu erhalten (das heißt, eine Ansicht, die IVsCodeWindow implementiert).

ownerCaption: String

Anfängliche Untertitel vom Dokumentbesitzer (d. h. dem Projekt) für das Dokumentfenster definiert. Diese hat häufig das folgende Format: "Projektname – Elementname".

hierarchy: IVsUIHierarchy

Ein Verweis auf die , die IVsUIHierarchy das Dokument besitzt.

itemId: UInt32

Der Benutzeroberflächenhierarchieelementbezeichner des Standard-Editors. Weitere Informationen finden Sie unter VSConstants.VSITEMID.

shouldGetDocDataFromRdt: Boolean

Wenn true, verwendet die Umgebung das aus der Tabelle "Laufendes Dokument" abgerufene Doc-Datenobjekt. Andernfalls öffnet der Dienst das Dokument mithilfe der an docDataübergebenen Dokumentdaten.

docData: Object

Ein Verweis auf das Dokumentdatenobjekt des zu öffnenden Elements oder null. Dieser an diesen Parameter übergebene Wert wird ignoriert, wenn shouldGetDocDataFromRdt ist true.

serviceProvider: IServiceProvider

Ein Verweis auf IServiceProvider.

Gibt zurück

IVsTask

Eine Aufgabe, die angibt, dass der geöffnete Vorgang gestartet wurde. Das Ergebnis der Aufgabe ist ein Verweis auf , IVsAsyncOpenDocumentResultwenn das Dokument in der Umgebung geöffnet wurde, nullandernfalls .

Hinweise

Die von dieser Methode zurückgegebene Aufgabe gibt nicht an, dass die Ansicht und die Dokumentdaten des Dokuments geladen wurden. Weitere Informationen finden Sie unter DocumentLoadTask.

Gilt für: