XMLNode-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 XMLNode-Steuerelement ist ein zugeordnetes XML-Knotenobjekt, das Ereignisse verfügbar macht und an Daten gebunden werden kann. Das XMLNode-Steuerelement wird nur erstellt, wenn ein sich nicht wiederholendes Schemaelement einem Microsoft Office Word-Dokument zugeordnet wird. Nachdem Visual Studio den XML-Knoten erstellt hat, können Sie beim Programmieren direkt darauf zugreifen, ohne das Word-Objektmodell durchlaufen zu müssen.

Das XMLNode-Steuerelement kann nur gelöscht werden, indem die Elementzuordnung in Word entfernt wird.

Binden von Daten an das Steuerelement

Ein XMLNode-Steuerelement unterstützt die einfache Datenbindung. Der XML-Knoten sollte mit der DataBindings-Eigenschaft an eine Datenquelle gebunden werden. Wenn die Daten im gebundenen Dataset aktualisiert werden, werden diese Änderungen vom XMLNode-Steuerelement nachvollzogen.

Formatierung

Die Formatierung für das Microsoft.Office.Interop.Word.XMLNode-Objekt kann auch auf das Microsoft.Office.Tools.Word.XMLNode-Steuerelement angewendet werden. Das schließt Schriftarten, Unterstreichungsstile und Zeichenformatvorlagen ein.

Ereignisse

Die folgenden Ereignisse sind für das XMLNode-Steuerelement verfügbar:

Vergleichen von Ereignissen

Sie können ein Ereignis erfassen, wenn der Benutzer den Cursor im Kontext eines bestimmten XMLNode-Steuerelements bewegt. Gehen wir im folgenden Beispiel davon aus, dass Sie ein XMLNode-Steuerelement mit dem Namen Customer mit einem untergeordneten XMLNode-Steuerelement mit dem Namen Company haben, wobei Company zwei untergeordnete XMLNode-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 XMLNode-Steuerelement hineinbewegt, werden in den meisten Fällen sowohl das Select-Ereignis und als auch das ContextEnter-Ereignis ausgelöst. In der folgenden Tabelle werden die Unterschiede zwischen diesen Ereignissen aufgeführt.

Select-Ereignis	ContextEnter-Ereignis
Wird ausgelöst, wenn der Cursor in einen XMLNode platziert wird.	Wird ausgelöst, wenn der Cursor ausgehend von einem Bereich außerhalb des Knotenkontexts in einen XMLNode oder von ihm abgeleiteten Knoten platziert wird. In anderen Worten: Das Ereignis wird nur ausgelöst, wenn sich der Kontext ändert.

Wenn Sie beispielsweise den Cursor außerhalb von Customer in CompanyName hineinbewegen, wird das ContextEnter-Ereignis für Customer, Company und CompanyName ausgelöst. Beim anschließenden Bewegen des Cursors von CompanyName nach CompanyRegion, wird das ContextEnter-Ereignis nur für CompanyRegion ausgelöst, da sich der Cursor immer noch im Kontext von Company und Customer befindet.

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