XMLNodes-Steuerelement

Aktualisiert: November 2007

Betrifft
Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office. Projekttyp Projekte auf Dokumentebene Microsoft Office-Version Word 2007 Word 2003 Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Das XMLNodes-Steuerelement ist eine Auflistung zugeordneter XML-Knotenobjekte, die Ereignisse verfügbar macht. Das XMLNodes-Steuerelement wird nur erstellt, wenn ein sich wiederholendes Schemaelement einem Microsoft Office Word-Dokument zugeordnet wird. Falls das sich wiederholende Element untergeordnete Elemente enthält, werden diese ebenfalls als XMLNodes-Steuerelemente erstellt.

Nachdem Visual Studio Tools for Office die Auflistung von XML-Knoten erstellt hat, können Sie sofort mit dem Steuerelement programmieren, ohne das Word-Objektmodell durchlaufen zu müssen. Das XMLNodes-Steuerelement kann nur gelöscht werden, indem die Elementzuordnung aus dem Dokument entfernt wird.

Hinweis:
Wenn Sie über die Item-Eigenschaft auf ein untergeordnetes Element des XMLNodes-Steuerelements zugreifen, wird ein Microsoft.Office.Interop.Word.XMLNode-Objekt und kein Microsoft.Office.Tools.Word.XMLNode-Steuerelement zurückgegeben. Weitere Informationen finden Sie unter Programmgesteuerte Einschränkungen von Hostelementen und Hoststeuerelementen.

Binden von Daten an das Steuerelement

Ein XMLNodes-Steuerelement unterstützt keine Datenbindung. Dies verhält sich deshalb so, weil das XMLNodes-Steuerelement keine komplexe Datenbindungsfähigkeiten besitzt und durch einfache Datenbindungen sich wiederholende Daten nicht dargestellt werden können.

Formatierung

Alle Formatierungen für Text innerhalb eines Dokuments können auch auf das XMLNodes-Steuerelement angewendet werden.

Ereignisse

Die dem XMLNodes-Steuerelement zur Verfügung stehenden Ereignisse sind:

• AfterInsert

• BeforeDelete

• ContextEnter

• ContextLeave

• Deselect

• Disposed

• Select

• ValidationError

Vergleichen von Ereignissen

Sie können ein Ereignis erfassen, wenn der Benutzer den Cursor im Kontext eines bestimmten XMLNodes-Steuerelements bewegt. Beispielsweise haben Sie wie folgend ein XMLNodes-Steuerelement mit dem Namen Customer mit einem untergeordneten XMLNodes-Steuerelement mit dem Namen Company, wobei Company zwei untergeordnete XMLNodes-Steuerelemente mit dem Namen CompanyName und CompanyRegion hat:

<Customer>
    <Company>
        <CompanyName>
        <CompanyRegion>

Wenn Sie im Aktionsbereich ein Steuerelement anzeigen lassen möchten, sobald der Cursor auf einen Company-Knoten bewegt wird, sollte es keine Rolle spielen, ob der Cursor über CompanyName oder CompanyRegion platziert wird, da beide im Kontext von Company liegen. In diesem Fall können Sie den Code in das ContextEnter-Ereignis von Company schreiben.

Sobald sich der Cursor in ein XMLNodes-Steuerelement hineinbewegt, werden in den meisten Fällen sowohl das Select-Ereignis als auch das ContextEnter-Ereignis ausgelöst. In der folgenden Tabelle werden Unterschiede zwischen diesen Ereignissen aufgeführt.

Select-Ereignis	ContextEnter-Ereignis
Tritt auf, wenn der Cursor auf einem der Knoten der XMLNodes-Auflistung platziert wird.	Tritt auf, wenn der Cursor außerhalb eines Bereichs des Knotenkontexts, in einem der Knoten oder der nachfolgenden Knoten der XMLNodes-Auflistung platziert wird. Mit anderen Worten: Es wird nur ausgelöst, wenn sich der Kontext ändert, und kann für mehrere geschachtelte XMLNodes-Steuerelemente ausgelöst werden.

Wenn Sie beispielsweise den Cursor außerhalb von Customer in CompanyName hineinbewegen, werden die ContextEnter-Ereignisse für Customer, Company und CompanyName ausgelöst. Wenn Sie anschließend den Cursors von CompanyName zu CompanyRegion bewegen, wird das ContextEnter-Ereignis nur für CompanyRegion ausgelöst, da der Kontext für Company und Customer gleich ist. Es können mehrere Company-Knoten im Dokument vorhanden sein. Wenn Sie den Cursor vom CompanyName-Knoten einer Company zum CompanyName-Knoten einer anderen Company bewegen, ist der Kontext gleich, sodass nur das Select-Ereignis ausgelöst wird.

Die gleichen Unterschiede bestehen zwischen dem ContextLeave-Ereignis und dem Deselect-Ereignis.

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen von XMLNodes-Steuerelementen zu Word-Dokumenten

Gewusst wie: Zuordnen von Schemas zu Word-Dokumenten in Visual Studio

Konzepte

Übersicht über Hostelemente und Hoststeuerelemente

XMLNode-Steuerelement

Programmgesteuerte Einschränkungen von Hostelementen und Hoststeuerelementen

Weitere Ressourcen

Word-Hoststeuerelemente

Excel-Hoststeuerelemente