Método EditorFactory.CreateEditorInstance

  • Artigo

Usado para criar o Visual Studio editor do núcleo, um editor que ofereça suporte a separação/modo de exibição de dados.

Namespace:  Microsoft.VisualStudio.Package
Assemblies:   Microsoft.VisualStudio.Package.LanguageService (em Microsoft.VisualStudio.Package.LanguageService.dll)
  Microsoft.VisualStudio.Package.LanguageService.9.0 (em Microsoft.VisualStudio.Package.LanguageService.9.0.dll)
  Microsoft.VisualStudio.Package.LanguageService.11.0 (em Microsoft.VisualStudio.Package.LanguageService.11.0.dll)
  Microsoft.VisualStudio.Package.LanguageService.10.0 (em Microsoft.VisualStudio.Package.LanguageService.10.0.dll)

Sintaxe

'Declaração
Public Overridable Function CreateEditorInstance ( _
    createDocFlags As UInteger, _
    moniker As String, _
    physicalView As String, _
    pHier As IVsHierarchy, _
    itemid As UInteger, _
    existingDocData As IntPtr, _
    <OutAttribute> ByRef docView As IntPtr, _
    <OutAttribute> ByRef docData As IntPtr, _
    <OutAttribute> ByRef editorCaption As String, _
    <OutAttribute> ByRef cmdUI As Guid, _
    <OutAttribute> ByRef cancelled As Integer _
) As Integer

public virtual int CreateEditorInstance(
    uint createDocFlags,
    string moniker,
    string physicalView,
    IVsHierarchy pHier,
    uint itemid,
    IntPtr existingDocData,
    out IntPtr docView,
    out IntPtr docData,
    out string editorCaption,
    out Guid cmdUI,
    out int cancelled
)

Parâmetros

  • createDocFlags
    Tipo: System.UInt32
    Sinalizadores que definem as condições sob as quais criar o principal editor.
  • moniker
    Tipo: System.String
    Formulário do identificador do identificador de origem do documento em seqüência no sistema de projeto.No caso de documentos que são arquivos, isso é sempre o caminho para o arquivo.Este parâmetro também pode ser usado para especificar os documentos que não são arquivos.Por exemplo, em um projeto orientado a banco de dados, este parâmetro pode conter uma seqüência de caracteres que se refere a registros em uma tabela.
  • physicalView
    Tipo: System.String
    Nome do modo de exibição físico.
  • itemid
    Tipo: System.UInt32
    Identificador de item da instância do editor do núcleo.
  • existingDocData
    Tipo: System.IntPtr
    Deve ser a docData o objeto que está registrado na tabela de documento em execução (RDT).Este parâmetro é usado para determinar se um buffer de documento (objeto de dados de documento) já foi criado.Quando uma fábrica de editor é solicitada para criar um modo de exibição secundário, em seguida, esse parâmetro será não-NULL indicando que não há nenhum buffer de documento.
  • docView
    Tipo: System.IntPtr%
    Objeto de exibição do documento.Retorna NULL se existir em um editor externo, caso contrário retorna o modo de exibição do documento.
  • docData
    Tipo: System.IntPtr%
    Objeto de dados do documento.Retorna o buffer para o documento.
  • editorCaption
    Tipo: System.String%
    Legenda inicial definida pelo editor do documento da janela do documento.Isso costuma ser uma seqüência de caracteres entre colchetes, como "[formulário]".Esse valor é passado como um parâmetro de entrada para o CreateDocumentWindow método.Se o arquivo [somente leitura] a legenda será definida durante o carregamento do arquivo.
  • cmdUI
    Tipo: System.Guid%
    Retorna o GUID da interface do usuário de comando.Esse GUID está ativo quando este editor é ativado.Qualquer elemento de interface do usuário que está visível no editor deve usar esse GUID.Esse GUID é usado no arquivo .ctc no satélite DLL onde indica quais menus e barras de ferramentas devem ser exibidas quando o documento estiver ativo.

Valor de retorno

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

Implementações

IVsEditorFactory.CreateEditorInstance(UInt32, String, String, IVsHierarchy, UInt32, IntPtr, IntPtr%, IntPtr%, String%, Guid%, Int32%)

Comentários

O Visual Studio editor núcleo é o manipulador de comandos principal.

Segurança do .NET Framework

Consulte também

Referência

EditorFactory Classe

Namespace Microsoft.VisualStudio.Package