Share via

Metodo EditorFactory.CreateEditorInstance

  • Articolo

utilizzato per creare Visual Studio editor principale, un editor che supporti la separazione/visualizzazione di dati.

Spazio dei nomi:  Microsoft.VisualStudio.Package
Assembly:   Microsoft.VisualStudio.Package.LanguageService (in Microsoft.VisualStudio.Package.LanguageService.dll)
  Microsoft.VisualStudio.Package.LanguageService.9.0 (in Microsoft.VisualStudio.Package.LanguageService.9.0.dll)
  Microsoft.VisualStudio.Package.LanguageService.11.0 (in Microsoft.VisualStudio.Package.LanguageService.11.0.dll)
  Microsoft.VisualStudio.Package.LanguageService.10.0 (in Microsoft.VisualStudio.Package.LanguageService.10.0.dll)

Sintassi

'Dichiarazione
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
)

Parametri

  • createDocFlags
    Tipo: System.UInt32
    Flag che definiscono le condizioni in cui creare editor principale.
  • moniker
    Tipo: System.String
    Stringa contenente il form dell'identificatore del moniker del documento nel sistema del progetto.Nel caso dei documenti che sono file, questo corrisponde sempre al percorso del file.Questo parametro può essere utilizzato per specificare i documenti che non sono file.Ad esempio, in un progetto orientato alla base dei dati, questo parametro può contenere una stringa che fa riferimento ai record di una tabella.
  • physicalView
    Tipo: System.String
    Nome della visualizzazione fisica.
  • itemid
    Tipo: System.UInt32
    Identificatore di dialogo principale dell'editor.
  • existingDocData
    Tipo: System.IntPtr
    deve essere docData l'oggetto che viene registrato nella Tabella (RDT) in esecuzione il documento.Questo parametro viene utilizzato per determinare se un buffer del documento (oggetto dati di documento) è già stato creato.Quando una factory dell'editor viene richiesto di creare una visualizzazione secondaria, questo parametro non verràNULL indica che non esiste un buffer del documento.
  • docView
    Tipo: System.IntPtr%
    Oggetto visualizzazione del documento.Restituisce NULL se un editor esterno esiste, in caso contrario restituisce la visualizzazione del documento.
  • docData
    Tipo: System.IntPtr%
    Oggetto dati del documento.restituisce il buffer per il documento.
  • editorCaption
    Tipo: System.String%
    Barra del titolo iniziale definita dall'editor del documento per la finestra del documento.Si tratta in genere di una stringa racchiusa tra parentesi quadre, come “[form]„.Questo valore viene passato come parametro di input a CreateDocumentWindow metodo.Se il file è [di sola lettura] la didascalia verrà impostata durante il caricamento del file.
  • cmdUI
    Tipo: System.Guid%
    Restituisce l'interfaccia utente GUID del comando.Il GUID è attivo quando questo editor viene attivato.Qualsiasi elemento dell'interfaccia utente che è visibile nell'editor necessario utilizzare questo GUID.Il GUID utilizzato nel file di .ctc nella DLL satellite dove indica quali menu e barre degli strumenti deve essere visualizzato quando il documento attivo.

Valore restituito

Tipo: System.Int32
Se il metodo ha esito positivo, restituisce S_OK.Se non riesce, restituisce un codice di errore.

Implementa

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

Note

Visual Studio l'editor principale è il gestore comando primario.

Sicurezza di .NET Framework

Vedere anche

Riferimenti

EditorFactory Classe

Spazio dei nomi Microsoft.VisualStudio.Package