Поделиться через


Пример использования элемента управления "подобласть" в панели действий

ПримечаниеПримечание.

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

В данном примере демонстрируются возможности настраиваемых пользовательских элементов управления в области действий, а также используется сворачиваемый элемент управления — контейнер (подобласть), предназначенный для упорядочения элементов управления в панели действий. В данном примере также показано, как реагировать на события, вызываемые элементами управления, расположенными в подобласти.

В данном примере имеется только один проект: проект документа Word с пользовательским элементом управления.

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

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

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

Образцы файлов:

C# 9wedct3f.load(ru-ru,VS.90).gif Просмотреть источник 9wedct3f.save(ru-ru,VS.90).gif Загрузить  
Visual Basic 9wedct3f.load(ru-ru,VS.90).gif Просмотреть источник 9wedct3f.save(ru-ru,VS.90).gif Загрузить  

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

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

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

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

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

Свойства:

  • Text. Текст, отображаемый в заголовке подобласти.

  • HighlightColor. Цвет заголовка при его выделении пользователем.

  • GradientBeginColor. Начальный цвет с одного края заголовка.

  • GradientEndColor. Конечный цвет с другого края заголовка.

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

  • IsAnimated. Указывает направление движения подобласти (вверх или вниз) при ее сворачивании и разворачивании.

Методы:

  • Expand. Разворачивает элемент управления. Если элемент управления развернут, метод не выполняет никаких действий.

  • Collapse. Сворачивает элемент управления. Если элемент управления свернут, метод не выполняет никаких действий.

События:

  • BeforeExpanding. Событие, возникающее перед разворачиванием элемента управления.

  • BeforeCollapsing. Событие, возникающее перед сворачиванием элемента управления.

  • AfterExpand. Событие, возникающее после разворачивания элемента управления.

  • AfterCollapse. Событие, возникающее после сворачивания элемента управления.

См. также

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

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

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