Пример заголовка справки панели действий

Обновлен: Ноябрь 2007

Примечание.
Данный пример работает только в Microsoft Office Excel 2007 и Microsoft Office Word 2007.

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

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

• UseAncestorAnnotation
  Указывает, должен ли элемент управления отображать текст примечания ближайшей родительской области, если он не задан в выбранной области.

• AnnotationType
  Определяет, отображается ли примечание о типе или имени элемента.

• PlaceholderText
  Текст, который элемент управления отображает при отсутствии примечания.

• ShowLocationName
  Переключатель отображения имени области в элементе управления заголовка справки.

В примере заголовка справки имеется одно решение с тремя проектами: проект библиотеки элементов управления, проект документа Word и проект книги Excel. Проекты Word и Excel демонстрируют, как использовать элемент управления. При щелчке других областей документа или листа заголовок справки отображает текст, который берется из области соответствующей схемы XML.

Примечание о безопасности.

Этот пример кода предназначен для иллюстрации концепции, и в нем приведен только код, который относится к этой концепции. Пример может не отвечать требованиям безопасности для конкретных условий, и его не следует использовать в точности в том виде, в котором он приведен. Чтобы сделать проект более безопасным и надежным, рекомендуется добавить в него код обеспечения безопасности и код обработки ошибок. Корпорация Майкрософт предоставляет этот пример кода на условиях "КАК ЕСТЬ", без каких-либо гарантий.

Сведения об установке демонстрационного проекта на локальный компьютер см. в разделе Практическое руководство. Установка и использование файлов примеров из справки.

Download sample

Для выполнения этого примера

• Нажмите клавишу F5.

Демонстрации

Этот пример демонстрирует, как создать пользовательский элемент управления и вставить его в проект, и как реагировать на события в областях, сопоставленных XML.

См. также

Основные понятия

Схемы и данные XML (Инструменты Visual Studio для Office)

Общие сведения о панели действий

Пошаговые руководства по настройке пользовательского интерфейса

Другие ресурсы

Примеры проектов уровня документа