IVsAsyncShellOpenDocument.OpenSpecificEditorAsync Método

Referencia

Definición

Espacio de nombres:: Microsoft.VisualStudio.Shell.Interop

Ensamblado:: Microsoft.VisualStudio.Interop.dll

Paquete:: Microsoft.VisualStudio.Interop v17.9.37000

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Abre de forma asincrónica un documento mediante el editor especificado.

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

Parámetros

openSpecificEditorFlags: UInt32

Marcas cuyos valores se toman de la __VSOSPEFLAGS enumeración.

documentMoniker: String

Forma de cadena del identificador de moniker único del documento en el sistema del proyecto, por ejemplo, la ruta de acceso completa al archivo. En casos de no archivo, este identificador suele tener el formato de una dirección URL.

editorType: Guid

que Guid identifica el editor que se va a usar para abrir el archivo.

physicalView: String

Nombre de la vista física o null.

Si es null, el entorno llama a MapLogicalView(Guid, String) en el generador del editor para determinar la vista física que corresponde a la vista lógica. En este caso, null no especifica la vista primaria, sino que indica que no sabe qué vista corresponde a la vista lógica.

logicalView: Guid

Que Guid identifica la vista lógica. La vista predeterminada es VSConstants.LOGVIEWID_Primary y cada editor debe admitir esa vista.

Si el editor implementa IVsMultiViewDocumentView en el objeto de vista de documento, el valor pasado a ActivateLogicalView(Guid), que determina qué vista se activa cuando se muestra la ventana del editor.

Al especificar la vista Guidlógica , puede solicitar la vista específica que coincida con el motivo por el que solicita la vista. Por ejemplo, especifique VSConstants.LOGVIEWID_Debugging para obtener la vista adecuada para la depuración o VSConstants.LOGVIEWID_TextView para obtener la vista adecuada para el editor de texto (es decir, una vista que implementa IVsCodeWindow).

ownerCaption: String

La subtítulo inicial definida por el propietario del documento (es decir, el proyecto) para la ventana del documento. Esto tiene a menudo el formato: "ProjectName – ItemName".

hierarchy: IVsUIHierarchy

Referencia al objeto IVsUIHierarchy que posee el documento.

itemId: UInt32

Identificador del elemento de jerarquía de la interfaz de usuario del editor estándar. Para obtener más información, vea VSConstants.VSITEMID.

shouldGetDocDataFromRdt: Boolean

Si truees , el entorno usará el objeto de datos de documento obtenido de la tabla de documentos en ejecución; de lo contrario, el servicio abrirá el documento con los datos del documento pasados a docData.

docData: Object

Referencia al objeto de datos del documento del elemento que se va a abrir o null. Este valor pasado a este parámetro se omite si shouldGetDocDataFromRdt es true.

serviceProvider: IServiceProvider

Una referencia a IServiceProvider.

Devoluciones

IVsTask

Tarea que representa que se ha iniciado la operación de apertura. El resultado de la tarea es una referencia a , IVsAsyncOpenDocumentResultsi el documento se abrió en el entorno; en caso contrario, null.

Comentarios

La tarea devuelta por este método no indica que la vista del documento y docdata se hayan cargado. Para obtener más información, consulte DocumentLoadTask.

Se aplica a

Compartir a través de