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

Статья
02/20/2013

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

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

Элемент управления XMLNode представляет собой сопоставленный объект узла XML, который предоставляет события и возможности привязки к данным.Элемент управления XMLNode создается только при сопоставлении неповторяющегося элемента схемы документу Microsoft Office Word.Созданный в Visual Studio узел XML можно программировать непосредственно, не обращаясь к объектной модели Word.

Удалить элемент управления XMLNode можно только путем удаления сопоставления элементов в Word.

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

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

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

Форматирование, которое может применяться к объекту Microsoft.Office.Interop.Word.XMLNode, также может применяться к элементу управления Microsoft.Office.Tools.Word.XMLNode.К таким функциям форматирования относятся шрифты, а также стили подчеркивания и знаков.

События

Для элемента управления XMLNode доступны следующие события:

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

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

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

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

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

Событие Select	Событие ContextEnter
Вызывается при перемещении курсора в элемент управления XMLNode.	Вызывается при перемещении курсора в элемент управления XMLNode или один из его дочерних узлов из области вне контекста данного узла.Другими словами, это событие вызывается только при изменении контекста.

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

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