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

Пошаговое руководство. Создание настраиваемой вкладки с помощью конструктора лент

  • Статья

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

Область применения. Сведения в этом разделе относятся к проектам уровня документа для Excel. Дополнительные сведения см. в разделе "Функции", доступные по Приложение Office ликации и типу проекта.

В этом пошаговом руководстве рассматриваются следующие задачи:

Примечание.

Отображаемые на компьютере имена или расположения некоторых элементов пользовательского интерфейса Visual Studio могут отличаться от указанных в следующих инструкциях. Это зависит от имеющегося выпуска Visual Studio и используемых параметров. Дополнительные сведения см. в разделе Персонализация интегрированной среды разработки Visual Studio.

Необходимые компоненты

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

Создание проекта книги Excel

Этапы использования конструктора лент практически идентичны для всех приложений Office. В этом примере используется книга Excel.

Создание проекта книги Excel

  • Создайте проект книги Excel с именем MyExcelRibbon. Дополнительные сведения см. в разделе How to: Create Office Projects in Visual Studio.

    Visual Studio открывает новую книгу в конструкторе и добавляет проект MyExcelRibbon в Обозреватель решений.

Создание областей действий

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

Создание панелей действий

  1. В меню Проект выберите пункт Добавить новый элемент.

  2. В диалоговом окне "Добавить новый элемент" выберите ActionsPaneControl и нажмите кнопку "Добавить".

    Файл ActionsPaneControl1.cs или ActionsPaneControl1.vb открывается в конструкторе.

  3. На вкладке "Общие элементы управления" панели элементов добавьте метку в область конструктора.

  4. В окне "Свойства" задайте для свойства Text метки1 значение Actions Pane 1.

  5. Повторите этапы 1–5, чтобы создать вторую панель действий и метку. Задайте для свойства Text второй метки значение Actions Pane 2.

Создание пользовательской вкладки

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

Создание настраиваемой вкладки

  1. В меню Проект выберите пункт Добавить новый элемент.

  2. В диалоговом окне Добавление нового элемента выберите элемент Лента (визуальный конструктор).

  3. Измените имя новой ленты на MyRibbon и нажмите кнопку "Добавить".

    В конструкторе лент откроется файл MyRibbon.cs или MyRibbon.vb ; отобразятся вкладка и группа, используемые по умолчанию.

  4. В конструкторе лент перейдите на вкладку по умолчанию.

  5. В окне "Свойства" разверните свойство ControlId и задайте для свойства ControlIdType значение Custom.

  6. Задайте для свойства Label значение My Custom Tab.

  7. В конструкторе ленты выберите группу 1.

  8. В окне "Свойства" задайте для диспетчера областей действий метки.

  9. На вкладке "Элементы управления лентой Office" панели элементов перетащите кнопку в группу 1.

  10. Нажмите кнопку1.

  11. В окне "Свойства" установите метку для отображения области действий 1.

  12. Добавьте в группу 1 вторую кнопку и задайте для свойства Label значение Show Actions Pane 2.

  13. На вкладке "Элементы управления лентой Office" на панели элементов перетащите элемент управления ToggleButton в группу 1.

  14. Задайте свойству Label значение "Скрыть область действий".

Скрытие и отображение панелей действий с помощью кнопок на пользовательской вкладке

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

Скрытие и отображение панелей действий при помощи кнопок настраиваемой вкладки

  1. В Обозреватель решений откройте контекстное меню для MyRibbon.cs или MyRibbon.vb, а затем выберите "Просмотреть код".

  2. Добавьте следующий код в начало класса MyRibbon. Данный код создает два объекта панелей действий.

    ActionsPaneControl1 actionsPane1 = new ActionsPaneControl1();
ActionsPaneControl2 actionsPane2 = new ActionsPaneControl2();

  3. Замените метод MyRibbon_Load приведенным ниже кодом. Данный код добавляет объекты панелей действий в коллекцию панелей действий Controls и скрывает объекты. Кроме того, код Visual C# присоединяет делегаты к нескольким событиям элементов управления ленты.

    private void MyRibbon_Load(object sender, RibbonUIEventArgs e)
{
    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane1);
    Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane2);
    actionsPane1.Hide();
    actionsPane2.Hide();
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;

    this.button1.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
        this.button1_Click);
    this.button2.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
        this.button2_Click);
    this.toggleButton1.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
        this.toggleButton1_Click);


}

  4. Добавьте следующие три метода обработчиков событий в класс MyRibbon. Эти методы обрабатывают события Click обеих кнопок и события Click выключателя. Обработчики событий button1 и button2 отображают соответствующие панели действий. Обработчик событий toggleButton1 отображает и скрывает активную панель действий.

    private void button1_Click(object sender, RibbonControlEventArgs e)
{
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    actionsPane2.Hide();
    actionsPane1.Show();
    toggleButton1.Checked = false;
}

private void button2_Click(object sender, RibbonControlEventArgs e)
{
    Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    actionsPane1.Hide();
    actionsPane2.Show();
    toggleButton1.Checked = false;

}

private void toggleButton1_Click(object sender, RibbonControlEventArgs e)
{
    if (toggleButton1.Checked == true)
    {
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;
    }
    else
    {
        Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
    }

}

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

При запуске проекта excel запускается, а вкладка "Моя настраиваемая вкладка " отображается на ленте. Выберите кнопки на вкладке "Моя пользовательская" , чтобы отобразить и скрыть области действий.

Тестирование настраиваемой вкладки

  1. Нажмите клавишу F5 для запуска проекта.

  2. Перейдите на вкладку "Моя настраиваемая вкладка ".

  3. В группе диспетчера настраиваемых действий выберите "Показать действия" 1.

    Откроется область действий и отображается область действий метки 1.

  4. Выберите "Показать действия" 2.

    Откроется область действий и отображается область действий метки 2.

  5. Выберите "Скрыть действия".

    Панели действий будут скрыты.

Следующие шаги

Дополнительные сведения о настройке пользовательского интерфейса Office см. в следующих разделах:

  • Добавление пользовательского интерфейса на основе контекста к настройкам уровня документа. Дополнительные сведения см. в обзоре области действий.

  • Расширение стандартной или пользовательской формы Microsoft Office Outlook. Дополнительные сведения см. в пошаговом руководстве. Проектирование области формы Outlook.

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