IVsAsyncShellOpenDocument.OpenSpecificEditorAsync Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.VisualStudio.Shell.Interop

Assembly:: Microsoft.VisualStudio.Interop.dll

Pacchetto:: Microsoft.VisualStudio.Interop v17.9.37000

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Apre in modo asincrono un documento utilizzando l'editor specificato.

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

Parametri

openSpecificEditorFlags: UInt32

Flag i cui valori sono tratti dall'enumerazione __VSOSPEFLAGS .

documentMoniker: String

Forma stringa dell'identificatore moniker univoco del documento nel sistema di progetto, ad esempio il percorso completo del file. In casi non di file, questo identificatore è spesso nel formato di URL.

editorType: Guid

Oggetto Guid che identifica l'editor da utilizzare per aprire il file.

physicalView: String

Nome della visualizzazione fisica o null.

Se null, l'ambiente chiama il metodo MapLogicalView(Guid, String) sulla factory dell'editor per determinare la visualizzazione fisica che corrisponde alla visualizzazione logica. In questo caso, null non specifica la visualizzazione primaria, bensì indica che non si conosce quale visualizzazione corrisponde alla visualizzazione logica.

logicalView: Guid

Oggetto Guid che identifica la vista logica. La visualizzazione predefinita è VSConstants.LOGVIEWID_Primary e ogni editor deve supportare tale visualizzazione.

Se l'editor implementa IVsMultiViewDocumentView nell'oggetto visualizzazione documento, il valore passato a ActivateLogicalView(Guid), che determina la visualizzazione attivata quando viene visualizzata la finestra dell'editor.

Specificando la vista Guidlogica , è possibile richiedere la visualizzazione specifica corrispondente al motivo per cui si sta richiedendo la vista. Ad esempio, specificare VSConstants.LOGVIEWID_Debugging per ottenere la visualizzazione appropriata per il debug o VSConstants.LOGVIEWID_TextView per ottenere la visualizzazione appropriata per l'editor di testo (ovvero una visualizzazione che implementa IVsCodeWindow).

ownerCaption: String

La didascalia iniziale definita dal proprietario del documento (ovvero il progetto) per la finestra del documento. È spesso del form: "ProjectName – ItemName".

hierarchy: IVsUIHierarchy

Riferimento all'oggetto IVsUIHierarchy proprietario del documento.

itemId: UInt32

Identificatore dell'elemento della gerarchia dell'interfaccia utente dell'editor standard. Per ulteriori informazioni, vedere VSConstants.VSITEMID.

shouldGetDocDataFromRdt: Boolean

Se true, l'ambiente utilizzerà l'oggetto dati doc ottenuto dalla tabella documento in esecuzione. In caso contrario, il servizio aprirà il documento usando i dati del documento passati a docData.

docData: Object

Riferimento all'oggetto dati del documento dell'elemento da aprire o null. Questo valore passato a questo parametro viene ignorato se shouldGetDocDataFromRdt è true.

serviceProvider: IServiceProvider

Riferimento a IServiceProvider.

Restituisce

IVsTask

Attività che rappresenta l'avvio dell'operazione di apertura. Il risultato dell'attività è un riferimento a un oggetto IVsAsyncOpenDocumentResult, se il documento è stato aperto all'interno dell'ambiente; in caso contrario, null.

Commenti

L'attività restituita da questo metodo non indica che la visualizzazione del documento e i dati docdata sono stati caricati. Per informazioni dettagliate, vedere DocumentLoadTask.

Si applica a

Condividi tramite