IVsAsyncShellOpenDocument.OpenSpecificEditorAsync Metodo
Definizione
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.IVsTaskPublic 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 IVsTaskParametri
- 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.
- 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
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.