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

Обзор панели действий

Это важно

Функция "Действия" была удалена из Microsoft Word, начиная с версии Office 2024. Эта функция доступна только в Microsoft Word с следующими выпусками Office:

  • Майкрософт 365
  • Office LTSC Профессиональный Плюс 2021
  • Office LTSC Стандарт 2021
  • Office профессиональный плюс 2016, 2019
  • Office стандартный 2016, 2019

Область действий — это настраиваемая область задач «Действия с документом », которая прикрепляется к определенному документу Microsoft Office Word или книге Microsoft Office Excel. Область действий размещается в области задач Office вместе с другими встроенными областями задач, такими как область задач «Источник XML » в Excel или область задач «Стили и форматирование» в Word. Для разработки пользовательского интерфейса области действий можно использовать элементы управления Windows Forms или WPF.

Применимо к: Информация в этой теме относится к проектам на уровне документов для Excel и Word. Для получения дополнительной информации см. Функции, доступные в Office по приложению и типу проекта.

Область действий можно создать только в настройках на уровне документа для Word или Excel. Вы не можете создать область действий в надстройке VSTO. Для получения дополнительной информации см. Функции, доступные в Office по приложению и типу проекта.

Примечание.

Область действий отличается от настраиваемых областей задач. Настраиваемые области задач связаны с приложением, а не с конкретным документом. В надстройках VSTO можно создавать настраиваемые области задач для некоторых приложений Microsoft Office. Для получения дополнительной информации см. Пользовательские панели задач.

Отображение области действий

Область действий представлена классом ActionsPane . При создании проекта уровня документа экземпляр этого класса доступен коду с помощью ActionsPane поля ThisWorkbook класса (для Excel) или ThisDocument (для Word) в проекте. Чтобы отобразить область действий, добавьте элемент управления Windows Forms в свойство ControlsActionsPane поля. В следующем примере кода в область действий добавляется элемент управления с именем actions .

this.ActionsPane.Controls.Add(actions);

Область действий становится видимой во время выполнения, как только вы явно добавляете в нее элемент управления. После отображения области действий можно динамически добавлять или удалять элементы управления в ответ на действия пользователя. Как правило, код добавляется для отображения области действий в Startup обработчике ThisDocument событий или ThisWorkbook так, чтобы область действий была видна при первом открытии документа пользователем. Однако может потребоваться отображать область действий только в ответ на действие пользователя в документе. Например, можно добавить код в Click событие элемента управления в документе.

Добавление нескольких элементов управления в область действий

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

  1. Создайте пользовательский интерфейс области действий, добавив в проект элемент управления панели действий или элемент пользовательского управления . Оба эти элемента включают пользовательский класс Windows Forms UserControl . Элементы "Элемент управления "Область действий" и "Пользовательский контроль" эквивалентны; Единственное отличие заключается в их названии.

  2. Добавьте элементы управления Windows Forms в систему UserControl с помощью конструктора или с помощью кода.

    Примечание.

    Вы также можете добавить элементы управления WPF в область действий, добавив WPF UserControl в Windows Forms UserControl. Дополнительные сведения см. в статье Использование элементов управления WPF в решениях Office.

  3. Добавьте экземпляр пользовательского пользовательского элемента управления в элементы управления, содержащиеся в ActionsPane поле ThisWorkbook класса (для Excel) или ThisDocument (для Word) в проекте.

    Примеры, демонстрирующие этот процесс более подробно, см. в статье Как добавить область действий в документы Word или книги Excel.

Скрытие области действий

ActionsPane Несмотря на то, что класс имеет Hide метод и Visible свойство, вы не можете удалить область действий из пользовательского интерфейса, используя какие-либо члены ActionsPane самого класса. Вызов Hide метода или установка Visible для свойства значения false скрывает только элементы управления в области действий, но не область задач.

Чтобы скрыть область задач в решении, можно воспользоваться несколькими способами:

  • Для Word задайте Visible для свойства TaskPane объекта, представляющего область задач "Действия с документом", значение false. Следующий пример кода предназначен для запуска из ThisDocument класса в проекте.

    this.Application.TaskPanes[Word.WdTaskPanes.wdTaskPaneDocumentActions].Visible = false;

  • Для Excel задайте DisplayDocumentActionTaskPane для свойства Application объекта значение false. Следующий пример кода предназначен для запуска из ThisWorkbook класса в проекте.

    this.Application.DisplayDocumentActionTaskPane = false;

  • В качестве альтернативы для Word или Excel можно задать Visible для свойства панели команд, представляющей область задач, значение false. Следующий пример кода предназначен для запуска из ThisDocument класса or ThisWorkbook в проекте.

    this.Application.CommandBars["Task Pane"].Visible = false;

Очистите область действий при открытии документа

Когда пользователь сохраняет документ в то время, когда отображается область действий, область действий отображается при каждом открытии документа, независимо от того, содержит ли область действий какие-либо элементы управления. Если вы хотите управлять его отображением, вызовите Clear метод поля ActionsPane в Startup обработчике ThisDocument событий или ThisWorkbook чтобы убедиться, что область действий не отображается при открытии документа.

Определение времени закрытия области действий

При закрытии области действий не возникает никаких событий. ActionsPane Несмотря на то, что в классе есть VisibleChanged событие, это событие не возникает, когда конечный пользователь закрывает область действий. Вместо этого это событие возникает, когда элементы управления в области действий скрыты путем вызова Hide метода или установки Visible для свойства значения false.

Когда пользователь закрывает область действий, он может снова отобразить ее, выполнив одну из следующих процедур в пользовательском интерфейсе приложения.

Отображение области действий с помощью пользовательского интерфейса Word или Excel

  1. На ленте перейдите на вкладку Вид .

  2. В группе Показать/Скрыть нажмите кнопку-переключатель Действия с документом .

События области действий программы

Вы можете добавить несколько пользовательских элементов управления в область действий, а затем написать код для реагирования на события в документе, отображая и скрывая пользовательские элементы управления. При сопоставлении элементов схемы XML с документом можно отображать определенные пользовательские элементы управления в области действий всякий раз, когда точка вставки находится внутри одного из элементов XML. Дополнительные сведения см . в разделах Как сопоставить схемы с документами Word в Visual Studio и Как сопоставить схемы с листами в Visual Studio.

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

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

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

Вы можете привязать элементы управления в области действий и элементы управления в документе к одному и тому же набору данных. Например, можно создать связь «основной/подробный» между элементами управления на панели действий и элементами управления на листе. Дополнительные сведения см. в разделе Пошаговое руководство: привязка данных к элементам управления в области действий Excel.

Проверка данных в элементах управления области действий

Если окно сообщения отображается в Validating обработчике событий элемента управления в области действий, событие может быть вызвано во второй раз при перемещении фокуса с элемента управления на окно сообщения. Чтобы предотвратить эту проблему, используйте ErrorProvider элемент управления для отображения любых сообщений об ошибках проверки.

Пользовательский контроль порядка укладки

Если вы используете несколько пользовательских элементов управления, вы можете написать код для правильного расположения пользовательских элементов управления на панели действий независимо от того, закреплена ли она вертикально или горизонтально. Порядок наложения пользовательских элементов управления в области действий можно задать с помощью StackStyle перечисления StackOrder свойства. Дополнительные сведения см . в разделе Как управлять макетом элемента управления в областях действий.

Свойство StackOrder может принимать следующие StackStyle значения перечисления.

Стиль укладки Определение
СБоттом Выполните группирование в нижней части панели действий.
ССлева Выполните группировку слева на панели действий.
СРайт Выполните группирование справа на панели действий.
Наверх Выполните группирование в верхней части панели действий.
Отсутствует Порядок укладки не определен; Заказ контролируется разработчиком.

Следующий код задает свойство StackOrder для размещения пользовательских элементов управления в верхней части области действий.

this.ActionsPane.StackOrder = Microsoft.Office.Tools.StackStyle.FromTop;

Элементы управления якорем

Если пользователь изменяет размер области действий во время выполнения, размер элементов управления может быть изменен вместе с областью действий. Свойство элемента управления Windows Forms можно использовать Anchor для привязки элементов управления к области действий. Таким же образом можно привязать элементы управления Windows Forms к пользовательскому элементу управления. Дополнительные сведения см. в разделе Практическое руководство: привязка элементов управления в Windows Forms.

Изменение размера области действий

Размер объекта ActionsPane нельзя изменить напрямую, так как он ActionsPane встроен в область задач. Однако ширину области задач можно изменить программным способом, задав Width свойство области CommandBar , представляющей область задач. Вы можете изменить высоту области задач, если она закреплена горизонтально или является плавающей.

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

this.CommandBars["Task Pane"].Width = 200;

Изменение положения области действий

Вы не можете напрямую изменить положение, ActionsPane так как оно встроено в область задач. Однако можно программно переместить область задач, задав Position свойство , CommandBar представляющее область задач.

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

this.CommandBars["Task Pane"].Position =
    Microsoft.Office.Core.MsoBarPosition.msoBarLeft;

Примечание.

Конечные пользователи могут вручную изменить положение области задач в любое время. Невозможно гарантировать, что область задач останется закрепленной в том месте, которое вы указываете программно. Тем не менее, вы можете проверить изменение ориентации и убедиться, что элементы управления на панели действий расположены в правильном направлении. Дополнительные сведения см . в разделе Как управлять макетом элемента управления в областях действий.

Установка Top свойств ActionsPane and Left не изменяет его положение, так как ActionsPane объект внедряется в область задач.

Если область задач не закреплена, можно задать Top свойства CommandBar andLeft, представляющие область задач. Следующий код перемещает незакрепленную область задач в левый верхний угол документа.

if (this.CommandBars["Task Pane"].Position == 
    Microsoft.Office.Core.MsoBarPosition.msoBarFloating)
{
    this.CommandBars["Task Pane"].Top = 0;
    this.CommandBars["Task Pane"].Left = 0;
}

Связанный контент