IVsUIShellOpenDocument.OpenSpecificEditor Método

Definição

Namespace:

Microsoft.VisualStudio.Shell.Interop

Assembly:

Microsoft.VisualStudio.Interop.dll

Pacote:

Microsoft.VisualStudio.Interop v17.12.40391

Abre um 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 obtidos da __VSOSPEFLAGS enumeração.

pszMkDocument

String

[in] Forma de cadeia de caracteres do identificador de moniker exclusivo do documento no sistema de projeto, por exemplo, o caminho completo para o arquivo. Em casos que não são de arquivo, esse identificador geralmente está na forma de uma URL.

rguidEditorType

Guid

[in] Identificador exclusivo do tipo de editor.

pszPhysicalView

String

[in] Nome do modo de exibição físico. Se nullfor , o ambiente chamará MapLogicalView(Guid, String) na fábrica do editor para determinar a exibição física que corresponde à exibição lógica. Nesse caso, null não especifica a exibição primária, mas indica que você não sabe qual exibição corresponde à exibição lógica.

rguidLogicalView

Guid

[in] GUID identificando a exibição lógica. Para obter uma lista de GUIDS de exibição lógica, consulte Exibição Lógica e Exibição Física. Se você implementar IVsMultiViewDocumentView no objeto de exibição de documento, o valor passado para o rguidLogicalView parâmetro determinará qual exibição será ativada quando a janela do editor for mostrada quando o editor for instanciado. Ao especificar o GUID de exibição lógica, o chamador de InitializeEditorInstance(UInt32, IntPtr, IntPtr, String, Guid, String, Guid, String, String, IVsUIHierarchy, UInt32, IntPtr, IServiceProvider, Guid, IVsWindowFrame) pode solicitar a exibição específica que corresponde ao motivo pelo qual o chamador está solicitando a exibição. Por exemplo, o chamador especificaria LOGVIEWID_Debugging para obter a exibição apropriada para a exibição de depuração ou LOGVIEWID_TextView para obter a exibição apropriada para o editor de texto (ou seja, uma exibição que implementa IVsCodeWindow).

pszOwnerCaption

String

[in] A legenda inicial definida pelo proprietário do documento (ou seja, o projeto) para a janela do documento. Isso geralmente é do formulário: "ProjectName – ItemName".

pHier

IVsUIHierarchy

[entrada] Ponteiro para a interface IVsUIHierarchy.

itemid

UInt32

[in] Identificador de item de hierarquia de interface do usuário para o editor especificado. Para obter mais informações, consulte VSITEMID.

punkDocDataExisting

IntPtr

nativeint

[entrada] Ponteiro para a interface IUnknown.

pSPHierContext

IServiceProvider

[entrada] Ponteiro para a interface IServiceProvide.

ppWindowFrame

IVsWindowFrame

[out, retval] Ponteiro para a IVsWindowFrame interface.

Retornos

Int32

Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.

Comentários

Assinatura COM

Em 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  
);