Método IVsUIShellOpenDocument.OpenDocumentViaProject (String, Guid, IServiceProvider, IVsUIHierarchy, UInt32, IVsWindowFrame)

Artigo
08/03/2016

Publicado: abril de 2016

Localiza um projeto adequado para abrir o documento.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (em Microsoft.VisualStudio.Shell.Interop.dll)

Sintaxe

int OpenDocumentViaProject(
    string pszMkDocument,
    [InAttribute] ref Guid rguidLogicalView,
    out IServiceProvider ppSP,
    out IVsUIHierarchy ppHier,
    out uint pitemid,
    out IVsWindowFrame ppWindowFrame
)

int OpenDocumentViaProject(
    String^ pszMkDocument,
    [InAttribute] Guid% rguidLogicalView,
    [OutAttribute] IServiceProvider^% ppSP,
    [OutAttribute] IVsUIHierarchy^% ppHier,
    [OutAttribute] unsigned int% pitemid,
    [OutAttribute] IVsWindowFrame^% ppWindowFrame
)

abstract OpenDocumentViaProject : 
        pszMkDocument:string *
        rguidLogicalView:Guid byref *
        ppSP:IServiceProvider byref *
        ppHier:IVsUIHierarchy byref *
        pitemid:uint32 byref *
        ppWindowFrame:IVsWindowFrame byref -> int

Function OpenDocumentViaProject (
    pszMkDocument As String,
    <InAttribute> ByRef rguidLogicalView As Guid,
    <OutAttribute> ByRef ppSP As IServiceProvider,
    <OutAttribute> ByRef ppHier As IVsUIHierarchy,
    <OutAttribute> ByRef pitemid As UInteger,
    <OutAttribute> ByRef ppWindowFrame As IVsWindowFrame
) As Integer

Parâmetros

pszMkDocument
[in] Formulário do identificador exclusivo do identificador de origem do documento em seqüência no sistema de projeto, por exemplo, o caminho completo para o arquivo.Em casos diferentes de arquivos, esse identificador é muitas vezes na forma de um URL.

rguidLogicalView
[in] Identificador exclusivo da visão lógica.Se o editor implementa IVsMultiViewDocumentView no objeto de exibição do documento, em seguida, o valor passado para o rguidLogicalView parâmetro determina o modo de exibição é ativado quando a janela do editor é mostrado quando o editor é instanciado.Especificando a GUID de exibição lógica, você pode solicitar o modo de exibição específico que coincida com o motivo pelo qual que você está solicitando o modo de exibição.Por exemplo, especificar LOGVIEWID_Debugging para obter o modo de exibição apropriado para a depuração, ou LOGVIEWID_TextView para obter o modo de exibição apropriado para o editor de texto (ou seja, um modo de exibição que implementa IVsCodeWindow).

ppSP
[out] Ponteiro para a interface IServiceProvideroledbinterfaces_implemented_by_the_provider.

ppHier
[out] Ponteiro para o IVsUIHierarchy interface do projeto que pode abrir o documento.

pitemid
[out] Ponteiro para o identificador de item de hierarquia do documento no projeto.Para obter mais informações, consulte: VSITEMID.

ppWindowFrame
[out, retval] Ponteiro para a moldura da janela que contém o editor.Para obter mais informações, consulte IVsWindowFrame.

Valor de retorno

Type: System.Int32

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

Comentários

COM assinatura

De vsshell.idl:

HRESULT IVsUIShellOpenDocument::OpenDocumentViaProject(
   [in] LPCOLESTR pszMkDocument,
   [in] REFGUID rguidLogicalView,
   [out] IServiceProvider **ppSP,
   [out] IVsUIHierarchy **ppHier,
   [out] VSITEMID *pitemid,
   [out, retval] IVsWindowFrame **ppWindowFrame
);

IVsUIShellOpenDocument.OpenDocumentViaProjectpode ser chamado para abrir qualquer projeto que é aberto via o Novo projeto ou Abrir projeto caixa de diálogo.Além disso, esse método também é chamado para abrir um documento em qualquer projeto que é adicionado à solução por meio de AddVirtualProject ou AddVirtualProjectEx.Um uso de exemplo disso é o DataView hierarquia, o que é na momento Server Explorer.Se um DataView hierarquia é adicionada à solução como um projeto virtual usando AddVirtualProject, em seguida, a OpenDocumentViaProject método pode abrir os itens do DataView hierarquias.Essa funcionalidade é importante, pois ele possibilita a depuração de procedimentos armazenados.

Consulte também

Interface IVsUIShellOpenDocument
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Partilhar via