Элемент управления XMLNodes

Статья
02/20/2013

Важным набор сведений в этом разделе, касающиеся Microsoft Word исключительно для использования преимущества и цене и организаций, найдены вне Соединенные Штаты и его территорий или используют или разработки программ, запущенных на продуктов Microsoft Word, которые были лицензированы Майкрософт до января 2010, когда выполненного реализация конкретной функциональности Майкрософт, связанное с пользовательским XML в Microsoft Word.Данная информация, относящаяся к Microsoft Word, не предназначена для чтения и использования лицами или организациями, расположенными в США или их территориях, которые используют продукты Microsoft Word, лицензированные корпорацией Майкрософт после 10 января 2010 г., или разрабатывают программы для этих продуктов; поведение данных продуктов отличается от поведения продуктов, лицензированных до указанной даты или приобретенных и лицензированных за пределами США.

Применение. Сведения этого раздела применяются к проектам уровня документа для Word 2013 и Word 2010. Дополнительные сведения см. в разделе Доступность функций по типам приложений Office и проектов.

Элемент управления XMLNodes представляет собой коллекцию сопоставленных объектов-узлов XML с событиями.Элемент управления XMLNodes создается только при сопоставлении повторяющегося элемента схемы документу Microsoft Office Word.Если повторяющийся элемент содержит дочерние элементы, каждый из дочерних элементов также создается как элемент управления XMLNodes.

После создания средой Visual Studio коллекции узлов XML элемент управления можно программировать непосредственно, не обращаясь к объектной модели Word.Удалить элемент управления XMLNodes можно только путем удаления из документа сопоставления элементов.

Примечание
При доступе к дочернему элементу элемента управления XMLNodes через свойство Item это свойство возвращает объект Microsoft.Office.Interop.Word.XMLNode, а не элемент управления Microsoft.Office.Tools.Word.XMLNode.Дополнительные сведения см. в разделе Программные ограничения ведущих элементов и элементов управления ведущего приложения.

При доступе к дочернему элементу элемента управления XMLNodes через свойство Item это свойство возвращает объект Microsoft.Office.Interop.Word.XMLNode, а не элемент управления Microsoft.Office.Tools.Word.XMLNode.Дополнительные сведения см. в разделе Программные ограничения ведущих элементов и элементов управления ведущего приложения.

Привязка данных к элементу управления

Элемент управления XMLNodes не поддерживает привязку данных.Причина заключается в том, что элемент управления XMLNodes не обладает возможностями привязки к сложным данным, а при простой привязке данных невозможно представить повторяющиеся данные.

Форматирование

К элементу управления XMLNodes можно применить любые параметры форматирования, применяемые к тексту документа.

События

Ниже перечислены события, доступные для элемента управления XMLNodes.

Сравнение событий

Перехватить событие можно в тот момент, когда пользователь перемещает курсор внутрь контекста конкретного элемента управления XMLNodes.Например, ниже приведена следующая ситуация: имеется элемент управления XMLNodes с именем Customer, у которого имеется дочерний элемент управления XMLNodes с именем Company, а элемент управления Company имеет два дочерних элемента управления XMLNodes с именами CompanyName и CompanyRegion.

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

Если необходимо отображать элемент управления в панели действий при каждом перемещении курсора в узел Company, не имеет значения, находится ли курсор в узле CompanyName или в узле CompanyRegion, поскольку оба они находятся в контексте узла Company.В этом случае код следует писать в обработчике событий ContextEnter элемента управления Company.

В большинстве случаев при перемещении курсора внутрь элемента управления XMLNodes возникает и событие Select, и событие ContextEnter.В приведенной ниже таблице показаны различия между этими двумя событиями.

Событие Select	Событие ContextEnter
Происходит при перемещении курсора внутрь одного из узлов коллекции XMLNodes.	Происходит при перемещении курсора внутрь одного из узлов или узлов-потомков коллекции XMLNodes из области за пределами контекста узла.Другими словами, это событие возникает только при изменении контекста и может возникать для нескольких вложенных элементов управления XMLNodes.

Происходит при перемещении курсора внутрь одного из узлов коллекции XMLNodes.

Происходит при перемещении курсора внутрь одного из узлов или узлов-потомков коллекции XMLNodes из области за пределами контекста узла.Другими словами, это событие возникает только при изменении контекста и может возникать для нескольких вложенных элементов управления XMLNodes.

Например, при перемещении курсора извне элемента управления Customer внутрь элемента управления CompanyName события ContextEnter возникают для элементов управления Customer, Company и CompanyName.Если после этого переместить курсор из элемента управления CompanyName в элемент управления CompanyRegion, событие ContextEnter возникнет только для элемента управления CompanyRegion, поскольку для элементов управления Company и Customer контекст не изменится.В документе может быть несколько узлов Company.При перемещении курсора из узла CompanyName одного элемента управления Company в узел CompanyName другого элемента управления Company контекст не изменится, поэтому возникнет только событие Select.

Аналогичным образом отличаются события ContextLeave и Deselect.