Share via


XMLNodes Interface

A collection of Microsoft.Office.Interop.Word.XMLNode objects that represent the nodes in the tree view of the XML Structure task pane, which indicates the elements that a user has applied to a document.

Namespace:  Microsoft.Office.Tools.Word
Assembly:  Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Syntax

'Declaration
<GuidAttribute("23ba8297-db6f-48b4-8730-8056ebde2d56")> _
Public Interface XMLNodes _
    Inherits IDisposable, ISupportInitialize
[GuidAttribute("23ba8297-db6f-48b4-8730-8056ebde2d56")]
public interface XMLNodes : IDisposable, 
    ISupportInitialize

The XMLNodes type exposes the following members.

Properties

  Name Description
Public property Application Gets a Microsoft.Office.Interop.Word.Application object that represents the Microsoft Office Word application.
Public property Container
Public property Count Gets the number of items in the XMLNodes collection.
Public property Creator Gets the application in which the XMLNodes control was created.
Public property InnerObject Gets a Microsoft.Office.Interop.Word.XMLNodes that represents the underlying native object for the XMLNodes control.
Public property Item Gets the Microsoft.Office.Interop.Word.XMLNode at the specified index.
Public property Parent Gets a Microsoft.Office.Interop.Word.Document that represents the document containing the XMLNodes collection.
Public property Tag Infrastructure.

Top

Methods

  Name Description
Public method Add Gets a Microsoft.Office.Interop.Word.XMLNode object that represents a newly added element.
Public method BeginInit Signals the object that initialization is starting. (Inherited from ISupportInitialize.)
Public method Dispose Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. (Inherited from IDisposable.)
Public method EndInit Signals the object that initialization is complete. (Inherited from ISupportInitialize.)
Public method GetEnumerator Gets the enumerator for the XMLNodes control.

Top

Events

  Name Description
Public event AfterInsert Occurs when the user adds a new Microsoft.Office.Interop.Word.XMLNode to the collection or to one of its descendents.
Public event BeforeDelete Occurs when the user deletes a Microsoft.Office.Interop.Word.XMLNode or descendent node from the collection, before the control is deleted.
Public event ContextEnter Occurs when the cursor is placed inside one of the nodes or descendant nodes of the XMLNodes collection, from an area outside of the context of the node.
Public event ContextLeave Occurs when the cursor is moved from one of the nodes or descendant nodes of the XMLNodes collection, to an area outside of the context of the original node.
Public event Deselect Occurs when the cursor is moved out of one of the nodes of the XMLNodes collection.
Public event Select Occurs when the cursor is placed inside one of the nodes of the XMLNodes collection.
Public event ValidationError Occurs when there is a validation error in the XMLNodes control.

Top

Remarks

The XMLNodes control represents a collection of XML elements with the same name. When you map elements that the schema allows to appear more than once onto a Microsoft Office Word document at design time, Visual Studio creates XMLNodes for the elements. A schema can allow an element to appear more than once when the maxOccurs attribute of the element or the element's ancestors is set to > 1.

If the schema sets the maxOccurs attribute for the element and its ancestors to 1, Visual Studio creates an XMLNode control instead.

XMLNodes controls can be created only in Word document-level projects at design time. They cannot be created at run time or in application-level projects. For more information, see XMLNodes Control and How to: Add XMLNodes Controls to Word Documents.

Note

This interface is implemented by the Visual Studio Tools for Office runtime. It is not intended to be implemented in your code. For more information, see Visual Studio Tools for Office Runtime Overview.

Usage

This documentation describes the version of this type that is used in Office projects that target the .NET Framework 4 and the .NET Framework 4.5. In projects that target the .NET Framework 3.5, this type might have different members and the code examples provided for this type might not work. For documentation about this type in projects that target the .NET Framework 3.5, see the following reference section in the Visual Studio 2008 documentation: https://go.microsoft.com/fwlink/?LinkId=160658.

See Also

Reference

Microsoft.Office.Tools.Word Namespace

Other Resources

XMLNodes Control

How to: Add XMLNodes Controls to Word Documents