EditorFactory.CreateEditorInstance(UInt32, String, String, IVsHierarchy, UInt32, IntPtr, IntPtr, IntPtr, String, Guid, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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.