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

Artigo
08/03/2016

Publicado: abril de 2016

Abre um editor especificado.

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

Sintaxe

int OpenSpecificEditor(
    uint grfOpenSpecific,
    string pszMkDocument,
    [InAttribute] ref Guid rguidEditorType,
    string pszPhysicalView,
    [InAttribute] ref Guid rguidLogicalView,
    string pszOwnerCaption,
    IVsUIHierarchy pHier,
    uint itemid,
    IntPtr punkDocDataExisting,
    IServiceProvider pSPHierContext,
    out IVsWindowFrame ppWindowFrame
)

int OpenSpecificEditor(
    unsigned int grfOpenSpecific,
    String^ pszMkDocument,
    [InAttribute] Guid% rguidEditorType,
    String^ pszPhysicalView,
    [InAttribute] Guid% rguidLogicalView,
    String^ pszOwnerCaption,
    IVsUIHierarchy^ pHier,
    unsigned int itemid,
    IntPtr punkDocDataExisting,
    IServiceProvider^ pSPHierContext,
    [OutAttribute] IVsWindowFrame^% ppWindowFrame
)

abstract OpenSpecificEditor : 
        grfOpenSpecific:uint32 *
        pszMkDocument:string *
        rguidEditorType:Guid byref *
        pszPhysicalView:string *
        rguidLogicalView:Guid byref *
        pszOwnerCaption:string *
        pHier:IVsUIHierarchy *
        itemid:uint32 *
        punkDocDataExisting:nativeint *
        pSPHierContext:IServiceProvider *
        ppWindowFrame:IVsWindowFrame byref -> int

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

Parâmetros

grfOpenSpecific
[in] Extraído de valores a __VSOSPEFLAGS enumeração.

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.

rguidEditorType
[in] Identificador exclusivo do tipo de editor.

pszPhysicalView
[in] Nome do modo de exibição físico.Se null, as chamadas de ambiente MapLogicalView na fábrica de editor para determinar o modo de exibição físico que corresponde ao modo de exibição lógico.Nesse caso, null Especifica o modo de exibição principal, mas em vez disso, indica que você não souber qual exibição corresponde ao modo de exibição lógico.

rguidLogicalView
[in] GUID que identifica o modo de exibição lógico.Para obter uma lista de GUIDS de exibição lógica, consulte modos de exibição lógico e físico.Se você implementar IVsMultiViewDocumentView em seu 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 é mostrada quando o editor é instanciado.Especificando o modo de exibição lógico GUID, o chamador de InitializeEditorInstance pode solicitar o modo de exibição específico que coincida com o motivo pelo qual o chamador está solicitando o modo de exibição.Por exemplo, o chamador deve especificar o LOGVIEWID_Debugging para obter o modo de exibição apropriado para depuração de modo de exibiçã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).

pszOwnerCaption
[in] Legenda inicial definida pelo proprietário do documento (ou seja, o projeto) da janela do documento.Isso costuma do formulário: "Nomedoprojeto – ItemName".

pHier
[in] Ponteiro para o IVsUIHierarchy interface.

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

punkDocDataExisting
[in] Ponteiro para o IUnknown interface.

pSPHierContext
[in] Ponteiro para o IServiceProvide interface.

ppWindowFrame
[out, retval] Ponteiro para o IVsWindowFrame interface.

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

Consulte também

Interface IVsUIShellOpenDocument
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Compartilhar via