Metodo EditorFactory.CreateEditorInstance

Articolo
10/30/2012

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.

pHier
Tipo: Microsoft.VisualStudio.Shell.Interop.IVsHierarchy
IVsHierarchy oggetto.

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.

cancelled
Tipo: System.Int32%
enumerazione di tipo __VSEDITORCREATEDOCWIN.Questi flag vengono passati a CreateDocumentWindow metodo.Questo valore è impostato su 0 in EditorFactory implementazione.

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

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

EditorFactory Classe

Spazio dei nomi Microsoft.VisualStudio.Package

Condividi tramite