IVsUIShellOpenDocument.OpenSpecificEditor Método

Definición

Espacio de nombres:

Microsoft.VisualStudio.Shell.Interop

Ensamblado:

Microsoft.VisualStudio.Interop.dll

Paquete:

Microsoft.VisualStudio.Interop v17.12.40391

Abre un editor especificado.

public:
 int OpenSpecificEditor(System::UInt32 grfOpenSpecific, System::String ^ pszMkDocument, Guid % rguidEditorType, System::String ^ pszPhysicalView, Guid % rguidLogicalView, System::String ^ pszOwnerCaption, Microsoft::VisualStudio::Shell::Interop::IVsUIHierarchy ^ pHier, System::UInt32 itemid, IntPtr punkDocDataExisting, Microsoft::VisualStudio::OLE::Interop::IServiceProvider ^ pSPHierContext, [Runtime::InteropServices::Out] Microsoft::VisualStudio::Shell::Interop::IVsWindowFrame ^ % ppWindowFrame);

public int OpenSpecificEditor (uint grfOpenSpecific, string pszMkDocument, ref Guid rguidEditorType, string pszPhysicalView, ref Guid rguidLogicalView, string pszOwnerCaption, Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy pHier, uint itemid, IntPtr punkDocDataExisting, Microsoft.VisualStudio.OLE.Interop.IServiceProvider pSPHierContext, out Microsoft.VisualStudio.Shell.Interop.IVsWindowFrame ppWindowFrame);

abstract member OpenSpecificEditor : uint32 * string * Guid * string * Guid * string * Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy * uint32 * nativeint * Microsoft.VisualStudio.OLE.Interop.IServiceProvider * IVsWindowFrame -> int

Public Function OpenSpecificEditor (grfOpenSpecific As UInteger, pszMkDocument As String, ByRef rguidEditorType As Guid, pszPhysicalView As String, ByRef rguidLogicalView As Guid, pszOwnerCaption As String, pHier As IVsUIHierarchy, itemid As UInteger, punkDocDataExisting As IntPtr, pSPHierContext As IServiceProvider, ByRef ppWindowFrame As IVsWindowFrame) As Integer

Parámetros

grfOpenSpecific

UInt32

[in] Valores procedentes de la enumeración __VSOSPEFLAGS.

pszMkDocument

String

[in] Forma de cadena del identificador único del moniker 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.

rguidEditorType

Guid

[in] Identificador único del tipo de editor.

pszPhysicalView

String

[in] Nombre de la vista física. 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.

rguidLogicalView

Guid

[in] GUID que identifica la vista lógica. Para obtener una lista de GUIDs de vista lógica, vea Vista lógica y vista física. Si implementa IVsMultiViewDocumentView en el objeto de vista de documento, el valor pasado al rguidLogicalView parámetro determina qué vista se activa cuando se muestra la ventana del editor cuando se crea una instancia del editor. Especificando el GUID de la vista lógica, el llamador de InitializeEditorInstance(UInt32, IntPtr, IntPtr, String, Guid, String, Guid, String, String, IVsUIHierarchy, UInt32, IntPtr, IServiceProvider, Guid, IVsWindowFrame) puede solicitar la vista concreta que coincide con la razón por la que el llamador está solicitando la vista. Por ejemplo, el llamador especificaría LOGVIEWID_Debugging para obtener la vista adecuada para depurar la vista o LOGVIEWID_TextView para obtener la vista adecuada para el editor de texto (es decir, una vista que implementa IVsCodeWindow).

pszOwnerCaption

String

[in] Leyenda inicial definida por el autor del documento (es decir, el proyecto) para la ventana de documento. Esto tiene a menudo el formato: "ProjectName – ItemName".

pHier

IVsUIHierarchy

[in] Puntero en la interfaz IVsUIHierarchy.

itemid

UInt32

[in] Identificador del elemento de la jerarquía de la interfaz de usuario para el editor especificado. Para obtener más información, vea VSITEMID.

punkDocDataExisting

IntPtr

nativeint

[in] Puntero en la interfaz IUnknown.

pSPHierContext

IServiceProvider

[in] Puntero en la interfaz IServiceProvide.

ppWindowFrame

IVsWindowFrame

[out, retval] Puntero en la interfaz IVsWindowFrame.

Devoluciones

Int32

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, devuelve un código de error.

Comentarios

Firma COM

Desde vsshell.idl:

HRESULT IVsUIShellOpenDocument::OpenSpecificEditor(  
   [in] VSOSPEFLAGS grfOpenSpecific,  
   [in] LPCOLESTR pszMkDocument,  
   [in] REFGUID rguidEditorType,  
   [in] LPCOLESTR pszPhysicalView,  
   [in] REFGUID rguidLogicalView,  
   [in] LPCOLESTR pszOwnerCaption,  
   [in] IVsUIHierarchy *pHier,  
   [in] VSITEMID itemid,  
   [in] IUnknown *punkDocDataExisting,  
   [in] IServiceProvider *pSPHierContext,  
   [out, retval] IVsWindowFrame **ppWindowFrame  
);