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

Статья
02/20/2013

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

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

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

Проектирование интерфейса с помощью элементов управления Windows Forms на элементе управления панели действий.
Отображение панели действий при открытии приложения.

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

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

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

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

Выпуск Visual Studio 2012, включающий инструменты разработчика Microsoft Office. Дополнительные сведения см. в разделе [Настройка компьютера для разработки решений Office](bb398242\(v=vs.110\).md).

Word 2013 или Word 2010.

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

Сначала следует создать проект документа Word.

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

Создайте проект документа Word с именем My Basic Actions Pane.Выберите в мастере Создать новый документ.Дополнительные сведения см. в разделе Практическое руководство. Создание проектов Office в Visual Studio.

Visual Studio откроет новый документ Word в режиме конструктора и добавит проект My Basic Actions Pane в Обозреватель Решений.

Добавление текста и закладок в документ

Панель действий будет посылать текст в закладки документа.Чтобы сконструировать документ, введете какой-либо текст в основную форму.

Добавление текста в документ

Введите следующий текст в документ Word:

21 марта, 2008

Имя

Адрес

Это пример базовой панели действий в Word.

Можно добавить элемент управления Bookmark к документу, перетащив его из элемента Панель элементов в Visual Studio или используя диалоговое окно Закладка в Word.

Добавление элемента управления "Закладка" в документ

Из закладки Элементы управления Word объекта Панель элементов перетащите элемент управления Bookmark в документ.

Откроется диалоговое окно Добавление элемента управления "Закладка".

Выберите слово Имя, не выбирая знак абзаца, и нажмите кнопку ОК.

Примечание
Знак абзаца должен находиться вне закладки.Если знаки абзаца невидимы в документе, щелкните меню Сервис, укажите пункт Средства Microsoft Office Word, и затем щелкните пункт Параметры.Щелкните вкладку Вид, и установите флажок Знаки абзаца в разделе Знаки форматирования диалогового окна Параметры.

Знак абзаца должен находиться вне закладки.Если знаки абзаца невидимы в документе, щелкните меню Сервис, укажите пункт Средства Microsoft Office Word, и затем щелкните пункт Параметры.Щелкните вкладку Вид, и установите флажок Знаки абзаца в разделе Знаки форматирования диалогового окна Параметры.

В окне Свойства, измените свойство Name объекта Bookmark1 на showName.
Выберите слово Адрес, не выбирая знак абзаца.
На вкладке Вставка на ленте, в группе Связи, щелкните Закладка.
В диалоговом окне Закладка введите showAddress в поле Имя закладки и щелкните пункт Добавить.

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

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

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

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

Добавление элементов управления Windows Forms в первый элемент управления панели действий

Если панель действий невидима в конструкторе, дважды щелкните InsertTextControl.
Со вкладки Общие элементы управленияпанели элементов, перетащите элемент управления Label на элемент управления панели действий.
Измените значение свойства Text элемента управления "Метка" на Имя.
Добавьте элемент управления TextBox к элементу управления панели действий и измените следующие свойства.

Свойство

Значение

Имя

getName

Размер

130, 20
Добавьте второй элемент управления Label к элементу управления панели действий и измените значение свойства Text на Address.
Добавьте второй элемент управления TextBox к элементу управления панели действий и измените следующие свойства.

Свойство

Значение

Имя

getAddress

Accepts Return

True

Multiline

True

Размер

130, 40
Добавьте элемент управления Button к элементу управления панели действий и измените следующие свойства.

Свойство

Значение

Имя

addText

Текст.

Атрибут Insert

Свойство	Значение
Имя	getName
Размер	130, 20

Свойство	Значение
Имя	getAddress
Accepts Return	True
Multiline	True
Размер	130, 40

Свойство	Значение
Имя	addText
Текст.	Атрибут Insert

Добавление кода для вставки текста в документ

В панели действий введите код, который вставляет текст и текстовые поля в соответствующие элементы управления Bookmark в документе.Можно использовать класс Globals для доступа к элементам управления в документе из элементов управления в панели действий.Дополнительные сведения см. в разделе Глобальный доступ к объектам в проектах Office.

Вставка текста из панели действий в закладку документа

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

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

    If Me.getName.Text <> String.Empty Then
        Globals.ThisDocument.showName.Text = Me.getName.Text
    End If

    If Me.getAddress.Text <> String.Empty Then
        Globals.ThisDocument.showAddress.Text = Me.getAddress.Text
    End If

    Me.getName.Text = String.Empty
    Me.getAddress.Text = String.Empty
End Sub

private void addText_Click(object sender, System.EventArgs e)
{
    if (this.getName.Text != String.Empty) 
    {
        Globals.ThisDocument.showName.Text = this.getName.Text;
    }

    if (this.getAddress.Text != String.Empty)
    {
        Globals.ThisDocument.showAddress.Text = this.getAddress.Text;
    }

    this.getName.Text = String.Empty;
    this.getAddress.Text = String.Empty;
}

В C# также необходимо добавить обработчик событий для события нажатия кнопки.Этот код можно поместить в конструктор InsertTextControl после обращения к IntializeComponent.Дополнительные сведения о создании обработчиков событий см. в разделе Практическое руководство. Создание обработчиков событий в проектах Office.
```
public InsertTextControl()
{
    InitializeComponent();
    this.addText.Click += new EventHandler(addText_Click);
}
```

Добавление кода для показа панели действий

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

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

Создайте новый экземпляр управляющего элемента панели действий в классе ThisDocument.
```
Dim insertText As New InsertTextControl
```
```
private InsertTextControl insertText = new InsertTextControl();
```
Добавьте следующий код в обработчик событий Startup книги ThisDocument.
```
Me.ActionsPane.Controls.Add(insertText)
```
```
this.ActionsPane.Controls.Add(insertText);
```

Тестирование приложения

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

Проверка документа

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

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

Далее будут рассмотрены следующие задачи:

Создание панели действий в Excel.Дополнительные сведения см. в разделе How to: Add an Actions Pane to Excel Workbooks.
Привязка данных к элементам управления в панели действий.Дополнительные сведения см. в разделе Пошаговое руководство. Привязка данных к элементам управления в панели действий Word.

См. также

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