EditorFactory.CreateEditorInstance(UInt32, String, String, IVsHierarchy, UInt32, IntPtr, IntPtr, IntPtr, String, Guid, Int32) Methode

Definition

Mit dieser Methode wird überprüft, ob es sich bei der angegebenen Datei um eine Datei handelt, die der Editor unterstützt. wenn dies der Fall ist, wird der Haupt Text-Editor erstellt und der Sprachdienst zugeordnet. Um herauszufinden, ob die Datei vom Editor unterstützt wird, führt die folgende Überprüfung durch: Wenn all dies zutrifft, wird der nächste Schritt fortgesetzt, um einen IVsTextLines-Puffer abzurufen und ihn wie folgt einzurichten: Schließlich ruft es "kreateeditorview" auf, um "DocView" zu erstellen.

public:
 virtual int CreateEditorInstance(System::UInt32 createDocFlags, System::String ^ moniker, System::String ^ physicalView, Microsoft::VisualStudio::Shell::Interop::IVsHierarchy ^ pHier, System::UInt32 itemid, IntPtr existingDocData, [Runtime::InteropServices::Out] IntPtr % docView, [Runtime::InteropServices::Out] IntPtr % docData, [Runtime::InteropServices::Out] System::String ^ % editorCaption, [Runtime::InteropServices::Out] Guid % cmdUI, [Runtime::InteropServices::Out] int % cancelled);
public virtual int CreateEditorInstance (uint createDocFlags, string moniker, string physicalView, Microsoft.VisualStudio.Shell.Interop.IVsHierarchy pHier, uint itemid, IntPtr existingDocData, out IntPtr docView, out IntPtr docData, out string editorCaption, out Guid cmdUI, out int cancelled);
abstract member CreateEditorInstance : uint32 * string * string * Microsoft.VisualStudio.Shell.Interop.IVsHierarchy * uint32 * nativeint * nativeint * nativeint * string * Guid * int -> int
override this.CreateEditorInstance : uint32 * string * string * Microsoft.VisualStudio.Shell.Interop.IVsHierarchy * uint32 * nativeint * nativeint * nativeint * string * Guid * int -> int
Public Overridable Function CreateEditorInstance (createDocFlags As UInteger, moniker As String, physicalView As String, pHier As IVsHierarchy, itemid As UInteger, existingDocData As IntPtr, ByRef docView As IntPtr, ByRef docData As IntPtr, ByRef editorCaption As String, ByRef cmdUI As Guid, ByRef cancelled As Integer) As Integer

Parameter

createDocFlags
UInt32

Flags, die die Bedingungen definieren, unter denen den Kerneditor erstellt wird.

moniker
String

Die Zeichenfolgenform des Moniker-Bezeichners des Dokuments im Projektsystem. Bei Dokumenten, die Dateien sind, ist dies immer der Pfad der Datei. Dieser Parameter kann auch verwendet werden, um Dokumente anzugeben, die keine Dateien sind. Beispiel: In einem datenbankorientierten Projekt kann dieser Parameter eine Zeichenfolge enthalten, die auf Datensätze in einer Tabelle verweist.

physicalView
String

Name der physischen Ansicht.

pHier
IVsHierarchy

Ein IVsHierarchy-Objekt.

itemid
UInt32

Elementbezeichner der Kerneditorinstanz.

existingDocData
IntPtr

Muss das docData-Objekt sein, das bei der aktiven Dokumenttabelle (RDT) registriert ist. Dieser Parameter wird verwendet, um zu bestimmen, ob bereits ein Dokumentenpuffer (Dokumenten-Datenobjekt) erstellt wurde. Wenn eine Editorfactory aufgefordert wird, eine sekundäre Ansicht zu erstellen, ist dieser Parameter nicht NULL, wodurch angegeben wird, dass kein Dokumentenpuffer vorhanden ist.

docView
IntPtr

Dokumentenansichtsobjekt. Gibt NULL zurück, wenn ein externer Editor vorhanden ist, gibt andernfalls die Ansicht des Dokuments zurück.

docData
IntPtr

Dokumenten-Datenobjekt. Gibt den Puffer für das Dokument zurück.

editorCaption
String

Ursprüngliche Beschriftung, definiert vom Dokument-Editor für das Dokumentfenster. Dies ist normalerweise eine Zeichenfolge, die in eckigen Klammern steht, beispielsweise "[Form]". Dieser Wert wird als Eingabeparameter an die CreateDocumentWindow(UInt32, String, IVsUIHierarchy, UInt32, IntPtr, IntPtr, Guid, String, Guid, IServiceProvider, String, String, Int32[], IVsWindowFrame)-Methode übergeben. Wenn die Datei [schreibgeschützt] ist, wird die Beschriftung während des Ladens der Datei festgelegt.

cmdUI
Guid

Gibt das GUID der Befehls-UI zurück. Dieser GUID ist aktiv, wenn dieser Editor aktiviert ist. Jedes im Editor sichtbare Benutzeroberflächenelement muss diese GUID verwenden. Dieser GUID wird in der .ctc-Datei in der Satelliten-DLL verwendet, in der er angibt, welche Menüs und Symbolleisten angezeigt werden sollen, wenn das Dokument aktiv ist.

cancelled
Int32

Enumeration vom Typ __VSEDITORCREATEDOCWIN. Diese Flags werden an die CreateDocumentWindow(UInt32, String, IVsUIHierarchy, UInt32, IntPtr, IntPtr, Guid, String, Guid, IServiceProvider, String, String, Int32[], IVsWindowFrame)-Methode übergeben. Dieser Wert ist auf 0 in der EditorFactory-Implementierung festgelegt.

Gibt zurück

Int32

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Implementiert

Hinweise

Ein Beispiel für die Verwendung dieser Methode finden Sie unter Exemplarische Vorgehensweise : Erstellen eines Kern Editors und Registrieren eines Editor Dateityps.

Gilt für