XMLNodes-Steuerelement

Artikel
08/10/2011

Wichtig Die in diesem Thema genannten Informationen zu Microsoft Word sind ausschließlich für Personen und Organisationen vorgesehen, die sich außerhalb der Vereinigten Staaten und ihrer Außengebiete befinden oder die Programme verwenden oder entwickeln, die unter Microsoft Word-Produkten ausgeführt werden, die von Microsoft vor Januar 2010 lizenziert wurden, als Microsoft eine Implementierung bestimmter Funktionen entfernte, die mit benutzerdefiniertem XML aus Microsoft Word zusammenhingen. Diese Informationen bezüglich Microsoft Word dürfen nicht von Personen oder Organisationen in den Vereinigten Staaten oder ihren Außengebieten verwendet werden, die Programme verwenden oder entwickeln, die unter Microsoft Word-Produkten ausgeführt werden, die von Microsoft nach dem 10. Januar 2010 lizenziert wurden. Diese Produkte verhalten sich nicht wie Produkte, die vor diesem Datum lizenziert oder für die Verwendung außerhalb der Vereinigten Staaten erworben und lizenziert wurden.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokumentebene für Word 2007 und Word 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-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 die Auflistung von XML-Knoten erstellt hat, können Sie das Steuerelement sofort zum Programmieren verwenden, ohne das Word-Objektmodell durchlaufen zu müssen. Das XMLNodes-Steuerelement kann nur gelöscht werden, indem die Elementzuordnung aus dem Dokument entfernt wird.

Tipp

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 folgenden Ereignisse sind für das XMLNodes-Steuerelement verfügbar:

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 möchten, sobald der Cursor auf den 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.