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

Руководство. Автоматизация приложения в настраиваемой области задач

  • Статья

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

Применение

Сведения в данном разделе относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office.

Тип проекта

  • Проекты уровня приложения

Приложение Microsoft Office

  • Excel 2007

  • InfoPath 2007

  • Outlook 2007

  • PowerPoint 2007

  • Word 2007

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

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

Несмотря на то, что данное руководство ориентировано на PowerPoint, рассматриваемые подходы применяются ко всем вышеперечисленным приложениям.

В руководстве представлены следующие задачи:

  • Проектирование пользовательского интерфейса в настраиваемой области задач.

  • Автоматизация PowerPoint в настраиваемой области задач.

  • Отображение настраиваемой области задач в PowerPoint.

Aa942861.alert_note(ru-ru,VS.90).gifПримечание.

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

Обязательные компоненты

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

  • Visual Studio Tools for Office (необязательный компонент Visual Studio 2008 Professional и Visual Studio Team System).

  • Microsoft Office PowerPoint 2007.

Visual Studio Tools for Office устанавливается по умолчанию с нижеперечисленными версиями Visual Studio. Для того чтобы проверить наличие установки данного пакета инструментов, см. раздел Установка средств Visual Studio для Office.

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

Первым этапом является создание проекта надстроек в PowerPoint.

Для того чтобы создать новый проект, выполните следующие действия.

  • Создайте проект надстройки PowerPoint с именем MyAddIn, используя шаблон проекта надстройки PowerPoint для системы Microsoft Office 2007. Дополнительные сведения см. в разделе Практическое руководство. Создание проектов Visual Studio Tools for Office.

    Visual Studio открывает файл кода ThisAddIn.cs или ThisAddIn.vb и добавляет проект MyAddIn к Обозревателю решений.

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

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

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

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

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

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

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

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

Автоматизация PowerPoint в настраиваемой области задач.

Задача надстроек состоит в том, чтобы разместить выбранную дату на первом слайде активной презентации. Используйте событие элемента управления DateChanged, чтобы добавить выбранную дату при изменениях.

Для того чтобы автоматизировать PowerPoint в настраиваемой области задач, выполните следующее.

  1. В конструкторе форм дважды нажмите элемент управления MonthCalendar.

    Как только открываются файлы MyUserControl.cs или MyUserControl.vb обработчик событийDateChanged создает событие.

  2. Добавьте следующую строку в начало файла. В этом коде создается псевдоним для Microsoft.Office.Core и пространства именMicrosoft.Office.Interop.PowerPoint.

    Imports Office = Microsoft.Office.Core
Imports PowerPoint = Microsoft.Office.Interop.PowerPoint

    using Office = Microsoft.Office.Core;
using PowerPoint = Microsoft.Office.Interop.PowerPoint;

  3. Добавьте в класс MyUserControl следующий код. Этот код объявляет экземпляр класса Microsoft.Office.Interop.PowerPoint.Shape членом класса MyUserControl. На следующем этапе мы будем использовать этот кодMicrosoft.Office.Interop.PowerPoint.Shape для добавления текстового окна на слайд активной презентации.

    Private TextBox As PowerPoint.Shape

    private PowerPoint.Shape textbox;

  4. Замените обработчик событий monthCalendar1_DateChanged следующим кодом. Этот код добавляет текстовое окно на первый слайд презентации и затем вставляет выбранную дату в тестовое окно. Код использует объект Globals.ThisAddIn для получения доступа к объектной модели PowerPoint.

    Private Sub MonthCalendar1_DateChanged( _
    ByVal sender As System.Object, _
    ByVal e As System.Windows.Forms.DateRangeEventArgs) _
    Handles MonthCalendar1.DateChanged

    Try
        If TextBox IsNot Nothing Then
            TextBox.Delete()
        End If

        Dim Slide As PowerPoint.Slide
        Slide = Globals.ThisAddIn.Application.ActivePresentation.Slides(1)
        TextBox = Slide.Shapes.AddTextbox( _
            Office.MsoTextOrientation.msoTextOrientationHorizontal, _
            50, 100, 600, 50)
        TextBox.TextFrame.TextRange.Text = e.Start.ToLongDateString()
        TextBox.TextFrame.TextRange.Font.Size = 48
        TextBox.TextFrame.TextRange.Font.Color.RGB = _
            System.Drawing.Color.DarkViolet.ToArgb()

    Catch ex As Exception
        System.Windows.Forms.MessageBox.Show(ex.ToString())
    End Try
End Sub

    private void monthCalendar1_DateChanged(object sender, DateRangeEventArgs e)
{
    try
    {
        if (textbox != null)
        {
            textbox.Delete();
        }

        PowerPoint.Slide slide =
            Globals.ThisAddIn.Application.ActivePresentation.Slides[1];
        textbox = slide.Shapes.AddTextbox(
            Office.MsoTextOrientation.msoTextOrientationHorizontal,
            50, 100, 600, 50);
        textbox.TextFrame.TextRange.Text = e.Start.ToLongDateString();
        textbox.TextFrame.TextRange.Font.Size = 48;
        textbox.TextFrame.TextRange.Font.Color.RGB =
             Color.DarkViolet.ToArgb();
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.ToString());
    }
}

  5. В Обозревателе решений нажмите правой кнопкой проект MyAddIn и выберите команду Построить. Убедитесь в том, что проект создается без ошибок.

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

Для того чтобы отобразить настраиваемую область задач во время осуществления надстроек; добавьте пользовательский элемент управления на панель задач Startup настроек обозревателя событий.

Для того чтобы отобразить настраиваемую область задач, выполните следующее.

  1. В Обозревателе решений откройте PowerPoint.

  2. Правой кнопкой нажмите файл ThisAddIn.cs или ThisAddIn.vb и выберите в меню функцию Просмотреть код.

  3. Добавьте в класс ThisAddIn следующий код. Этот код объявляет экземпляры MyUserControl и CustomTaskPane членами класса ThisAddIn.

    Private myUserControl1 As MyUserControl
Private myCustomTaskPane As Microsoft.Office.Tools.CustomTaskPane

    private MyUserControl myUserControl1;
private Microsoft.Office.Tools.CustomTaskPane myCustomTaskPane;

  4. Замените обработчик событий ThisAddIn_Startup следующим кодом. Этот код создает новый CustomTaskPane, добавляя объект MyUserControl в коллекцию CustomTaskPanes. Код также отображает панель задач.

    Private Sub ThisAddIn_Startup(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Me.Startup

    myUserControl1 = New MyUserControl
    myCustomTaskPane = Me.CustomTaskPanes.Add(myUserControl1, "Calendar")
    myCustomTaskPane.Visible = True
End Sub

    private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    myUserControl1 = new MyUserControl();
    myCustomTaskPane = this.CustomTaskPanes.Add(myUserControl1, "Calendar");
    myCustomTaskPane.Visible = true;
}

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

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

Чтобы проверить надстройки, выполните следующее.

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

  2. Убедитесь в том, что панель задач отображается.

  3. Нажмите дату MonthCalendar элемента управления в панели задач.

    Дата вставляется на первом слайде активной презентации.

Следующие действия

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

См. также

Задачи

Практическое руководство. Добавление настраиваемой панели задач в приложение

Пошаговое руководство. Синхронизация настраиваемой области задач с кнопкой на ленте

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

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

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

Общие сведения о настраиваемых областях задач

Управление настраиваемыми областями задач в нескольких окнах приложений