Элемент управления XMLNode
Обновлен: Ноябрь 2007
Применение |
|---|
Сведения в данном разделе относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office. Тип проекта
Версия Microsoft Office
Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов. |
Элемент управления XMLNode представляет собой сопоставленный объект узла XML, который предоставляет события и возможности привязки к данным. Элемент управления XMLNode создается только при сопоставлении неповторяющегося элемента схемы документу Microsoft Office Word. Созданный в Visual Studio Tools for Office узел 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.
См. также
Задачи
Практическое руководство. Добавление элементов управления XMLNode в документы Word
Практическое руководство. Сопоставление схем и документов Word в Visual Studio
Пошаговое руководство. Изменение панели действий в зависимости от контекста пользователя
Основные понятия
Общие сведения о ведущих элементах и элементах управления ведущего приложения
Программные ограничения ведущих элементов и элементов управления ведущего приложения