Dokumenten-Bezugspunkte und benutzerdefinierte Editoren in Dokumenten-Ansicht

Artikel
05/16/2015

Ein benutzerdefinierter Editor besteht aus zwei Teilen: Dokumente an das angegebene Channeldatenobjekt ein Objekt der Dokumente und ein. Wie die Namen vorschlagen, stellt das Dokument das angegebene Channeldatenobjekt die angezeigt werden sollen, Zeichendaten dar, und das Objekt der Dokumente (oder die Ansicht“) stellt in denen eine oder mehrere Fenster dar, das Dokument anzuzeigen. das angegebene Channeldatenobjekt

Dokumenten-Datenobjekt

Ein Dokumente an das angegebene Channeldatenobjekt ist eine Informationsdarstellung des Texts im Textpuffer. Dabei handelt es sich um ein COM-Objekt, das Dokumenttext und andere Informationen speichert, Dokumenten und behandelt Dauerhaftigkeit mehrere Ansichten der Daten ermöglicht. Weitere Informationen finden Sie unter

DocumentData und Dokumentfenster.

Benutzerdefinierte Editoren und Designern können entscheiden, das VsTextBuffer-Objekt oder einen eigenen benutzerdefinierten Puffer zu verwenden. Mithilfe von eingebettetenVsTextBuffer folgt dem abgeflachten Modell für einen standardmäßigen Editor unterstützt mehrere Ansichten und stellt Ereignisschnittstellen, die verwendet werden, um mehrere Ansichten zu verwalten.

Dokumenten-Ansichts-Objekt

Ein Fenster mit anderen Code and Text anzeigt, bekannt als Dokumenten oder Ansicht anzeigen. Wenn Sie einen Editor erstellen, können Sie entweder eine einzelne Ansicht auswählen, in der Text in einem Fenster angezeigt wird, eine oder mehrere Ansicht, in der Text in mehr als einem Fenster angezeigt wird. Die Wahl hängt von der Anwendung ab. Wenn Sie beispielsweise parallele Bearbeiten benötigen, geben Sie mehrere Ansicht auswählen. Jede Ansicht wird mit einem Eintrag in der Tabelle Dokumente der integrierten Entwicklungsumgebung (IDE) (Drehtransformator) zugeordnet. Ansichtsfenster gehören zu einem Projekt oder einer IVsHierarchy-Objekt.

Wenn der Editor mehrere Ansichten eines Dokuments datenobjekts unterstützt, dann müssen die Dokumentdaten der Dokumente und die Objekte unabhängig sein. Andernfalls können sie zusammen gruppiert werden. Weitere Informationen finden Sie unter Unterstützung mehrerer Dokumenten-Ansichten.

Die IDE benachrichtigt Ansichten zu Ereignissen (z. B. wenn eine Projektmappe, die ein Dokument enthält, geschlossen wurde), indem Sie einen Elementbezeichner (ItemID) für jeden Eintrag in der Tabelle Dokument übereinstimmt. Weitere Informationen hierzu finden Sie unter Ausgeführte Tabelle aktiver Dokumente.

Es gibt zwei Möglichkeiten zum Erstellen einer Ansicht für einen benutzerdefinierten Editor. Eines ist das Modell der Symbolleiste Aktivierung, in dem die Ansicht in einem Fenster entweder mithilfe eines Dokuments oder eines ActiveX-Steuerelements datenobjekts gehostet wird. Das zweite Element ist das vereinfachte Mithilfe von eingebetteten Modell, in dem die Ansicht durch Visual Studio gehostet wird und IVsWindowPane Fenster implementiert wird, um Befehle zu behandeln. Weitere Informationen über das Modell der direkte Aktivierung finden Sie unter Direkte Aktivierung. Weitere Informationen über das vereinfachte Mithilfe von eingebetteten Modells finden Sie unter Vereinfachte Einbettung.