Практическое руководство. Добавление области действий в документы Word или книги Excel

Статья
02/20/2013

Добавление панели действий к документу слова Microsoft Office или книге Microsoft Excel, сначала создайте пользовательский элемент управления Windows Forms.Затем добавьте пользовательский элемент управления со свойством Controls поля ThisDocument.ActionsPane (слов) или поля ThisWorkbook.ActionsPane (Excel) в проекте.

Применение. Сведения этого раздела применяются к проектам уровня документа для следующих приложений: Excel 2013 и Excel 2010; Word 2013 и Word 2010. Дополнительные сведения см. в разделе Доступность функций по типам приложений Office и проектов.

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

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

Создание пользовательского элемента управления

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

Создание пользовательского элемента управления

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

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

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

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

Со вкладки Windows Forms панели Панель элементов перетащите элемент управления Кнопка на элемент управления.

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

Добавьте код к обработчику событий Click кнопки.Следующий код выставок примера документа слова Microsoft Office.

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    Handles Button1.Click

    Globals.ThisDocument.Paragraphs(1).Range.Text = "Hello world!"
End Sub

private void button1_Click(object sender, System.EventArgs e)
{
    Globals.ThisDocument.Paragraphs[1].Range.Text = "Hello World!";
}

В C# также необходимо добавить обработчик событий для события нажатия кнопки.Этот код можно поместить в конструктор HelloControl после обращения к IntializeComponent.

Дополнительные сведения о создании обработчиков событий см. в разделе Практическое руководство. Создание обработчиков событий в проектах Office.
```
public HelloControl()
{
    InitializeComponent();
    this.button1.Click += new EventHandler(this.button1_Click);
}
```

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

Чтобы отобразить панель действий, добавьте пользовательский элемент управления со свойством Controls поля ThisDocument.ActionsPane (слов) или поля ThisWorkbook.ActionsPane (Excel).

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

Добавьте следующий код в класс ThisDocument или ThisWorkbook в качестве объявления уровня класс- (не добавляйте этот код в метод).
```
Dim hello As New HelloControl
```
```
private HelloControl hello = new HelloControl();
```
Добавьте следующий код в обработчик событий ThisDocument_Startup класса ThisDocument или обработчик событий ThisWorkbook_Startup класса ThisWorkbook.
```
Me.ActionsPane.Controls.Add(hello)
```
```
this.ActionsPane.Controls.Add(hello);
```